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About This Book 


This book is intended to help customers diagnose vtam problems. It contains diag¬ 
nostic procedures and information, which must not be used as programming inter¬ 
faces. Any references to programming interfaces are for diagnostic purposes only. 


Who Should Use This Book 

System programmers should use this book to analyze a vtam problem, classify it 
as a specific type, and then describe it to an ibm Support Center. You should be 
familiar with vtam's service aids, and you should know how to report problems to 
the ibm Support Center. You should also be familiar with the information in the fol¬ 
lowing books: 

• Network Program Products: General Information, GC30-3350 

• Programming System General Information Manual, G229-2228. 


How To Use This Book 

Follow these steps to diagnose a problem: 

1. Determine which licensed program is causing the problem in your network. 

You can get help with this step from Network Program Products Problem Deter¬ 
mination (SC30-3250), from your branch office, or from the ibm Support Center 
(Level 1). 

• If the problem is in vtam, tso/vtam, or vscs, you are using the right book. 

• If the problem is in the hardware or in some other licensed program, you 
are using the wrong book. You should be using the Diagnosis Guide for 
that product. 

2. Use Chapter 1, “Documentation to Collect for All Problem Types" to collect the 
information you will need to report to ibm for all problems, regardless of type. 

3. Use external symptoms to determine the type of problem. Chapter 2, “Classi¬ 
fying the Problem's Symptoms" describes these symptoms. 

4. Follow the procedure for your type of problem to find its source (if possible), 
and to continue collecting the documentation that the ibm Support Center needs 
to solve the problem. 

• Chapter 3, “Procedures for Specific Problem Types" gives diagnosis pro¬ 
cedures for vtam problems. 

• Chapter 4, “ mvs Procedures for for TSO/VTAM Problems" gives procedures 
for tso/vtam problems. 

• Chapter 5, " VM Procedures for VSCS Problems" gives procedures for vscs 
problems. 

Chapters 6, 7, and 8 describe the vtam service aids you can use to collect the 
problem documentation you need. Go to these chapters to collect output from 
traces and dumps. 

The appendixes contain information you may need to refer to when you are 
diagnosing problems. 
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Note: Appendix C, “Network Flows” describes aspects of the internal proc¬ 
essing of VTAM. The information in that appendix is provided for problem 
diagnosis purposes only. Customers are strongly discouraged against using 
the information in that appendix for purposes other than those for which it is 
intended. 

Notes: 

a. You may need to see VTAM Operation for the exact syntax for some com¬ 
mands. 

b. Operating system books can assist you in getting output from operating 
system service aids. 

c. If you have access to a software support data base, you can search for 
your problem in that data base and apply the recommended correction, if 
there is one. 

5. After collecting the necessary documentation, report the problem to the ibm 
Support Center. 

You can find information on how to work with the ibm Support Center, and how 
to carry out their suggestions, in the Programming System General Information 
Manual , G229-2228. 

6. If the problem has not been reported before, Level 1 may forward the problem 
to Level 2. Keep all of your supporting documentation on hand to help the 
Level 2 representative solve your problem. 

Technical terms used in this book are defined in the glossary, beginning on page 
/GLOSS/. 

Symbols Used in This Book 

The following symbols are used in this book to indicate information that pertains to 
a specific operating system: 

mvs/xa Indicates information that applies to mvs/xa only. 

mvs/370 Indicates information that applies to mvs/370 only. 

mvs Indicates information that applies to both mvs/xa and mvs/370, but not to 

vm or VSE. 

vm Indicates information that applies to vm only. 

vse Indicates information that applies to vse only. 

Note: Because vsE/Advanced Functions is one of the licensed programs 
in vsE/System Package, no distinction is made between the two. 

These symbols precede unique information. If a piece of information applies to 
more than one operating system, but not to all of them, more than one symbol may 
precede the information. For example: 

mvs vse This function locates the resource in this network or another 
network associated with a given symbolic name or network address . 

The above information applies to mvs/xa, mvs/370, and vse. 

Information that applies to all operating systems is not denoted by a symbol. 
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Artwork Used in This Book 

Figure 1 shows the conventions used in this book to illustrate the parts of a 
network. 
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Figure 1. Conventions Used in Network Illustrations 
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What Is New in This Book (Fifth Edition) 

For mvs: 

• lu 6.2 support has been added to this book, including new vtam internal trace 
records and dump records for lu 6.2. 

• A new controller, the 3720 Communication Controller with an attached disk, 
allows ncp, moss, and csp dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as a ptf in 
V3R1.1 and as part of the base code in V3R2. 

• A new controller, the 3745 Communication Controller, allows bus-switching 
between central control units (ecus) for twin-ccu 3745s, and allows the 
recording of 3745 network management vector transport (nmvt) alerts in 
logrec. 3745 support is available as a ptf in V3R1.1 (the 3720 disk support ptf is 
a prerequisite) and as part of the base code in V3R2. 

• The tracing of cpwait, cppost, cppurge, disp, schd, and que trace records has 
been streamlined. 

• The sscp and pss vtam internal trace options have each been split into two 
options (sscp and nrm, and pss and esc). 

• Information about vtam V3R1 for mvs has been deleted. For information about 
vtam V3R1 mvs, see the previous edition of the VTAM Diagnosis Guide 
(SC23-0116). 

For vm: 

• lu 6.2 support has been added to this book, including new vtam internal trace 
records and dump records for lu 6.2. 

• Local area network (lan) support has been added to this book, including new 
vtam internal trace records. 

• x.25 support has been added to this book, including new vtam internal trace 
records. 

• A new controller, the 3720 Communication Controller with an attached disk, 
allows ncp, moss, and csp dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as a ptf in 
V3R1.1 and as part of the base code in V 3 R 1.2 and V3R2. 

• A new controller, the 3745 Communication Controller, allows bus-switching 
between central control units (ecus) for twin-ccu 3745s, and allows the 
recording of 3745 network management vector transport (nmvt) alerts in 
logrec. 3745 support is available as part of the base code in V3R2. 

• New vtam exit data trace entries have been added — dtivrecx, dtivresx, and 

DTIVSEND. 

• The tracing of cpwait, cppost, cppurge, disp, schd, and que trace records has 
been streamlined. 

• The sscp and pss vtam internal trace options have each been split into two 
options (sscp and nrm, and pss and esc). 

• The vses data, fre, and get trace options have been added. 
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• New problem diagnosis procedures for vscs have been added, including: 

- General procedures to diagnose logical unit hang problems (page 94) 

- Procedures for determining device characteristics (page 97) 

- Procedures for Resolving vm/sp logo problems on an sna device (page 113). 

• vtam V3R1.2 and later can now use the alert function to notify an operator of an 
actual or impending loss of availability of a resource, vtam builds a network 
management vector transport (nmvt) for the alert. The nmvt can be traced with 
the piu option of the vit. 

• Revisions have been made to vscs storage management to allow the swapping 
and releasing of vscs dynamic storage. 

• Information about vtam V3R1 for vm has been deleted. For information about 
vtam V3Ri vm, see the previous edition of the VTAM Diagnosis Guide 
(SC23-0116). 

For vse: 

• Local area network (lan) support has been added to this book, including new 
vtam internal trace records. 

• x.25 support has been added to this book, including new vtam internal trace 
records. 

• A new controller, the 3720 Communication Controller with an attached disk, 
allows ncp, moss, and csp dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as part of the 
base code in V3R2. 

• A new controller, the 3745 Communication Controller, allows bus-switching 
between central control units (ecus) for twin-ccu 3745s, and allows the 
recording of 3745 network management vector transport (nmvt) alerts in 
logrec. 3745 support is available as part of the base code in V3R2. 

• The format of the message numbers has been changed so that message 
numbers now begin with "ist” instead of the number “5”. 

• The tracing of cpwait, cppost, cppurge, disp, schd, and que trace records has 
been streamlined. 

• The dsco, nrsp, oper, and rce entries for the vtam internal trace have been 
included. 

• The sscp and pss vtam internal trace options have each been split into two 
options (sscp and nrm, and pss and esc). 


Where To Find More Information 

Figure 2 on page xviii shows the books in the vtam V3R2 library, arranged 
according to related tasks. For a description of these books, see the 
“Bibliography” on page 671. The bibliography also lists the titles and order 
numbers of books related to this book or cited by name in this book. 
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Figure 2. The VTAM V3R2 Library 
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Chapter 1. Documentation to Collect for All Problem Types 

The following chart describes documentation you should have for all types of prob¬ 
lems. 

Note: Documentation for the NetView™ program 1 is included in the chart. 


Documentation 

Description 

Component ID 

V3R1 



Component 

VTAM (VSE) 

ID 

5666-31301-H50 


V3R1.1 



Component 

VTAM (MVS/370) 
VTAM (MVS/XA) 

VTAM (VM) 

ID 

5665-31301-112 

5665-28901-113 

5664-28001-311 


V3R1.2 



Component 

VTAM (VM) 

VTAM (VSE) 

ID 

5664-28001-312 

5666-31301-H52 


V3R2 



Component 

VTAM (MVS/370) 
VTAM (MVS/XA) 

VTAM (VM) 

VTAM (VSE) 

ID 

5665-31301-204 

5665- 28901-205 

5664-28001-320 

5666- 31301-G69 


Information about the release level of each compo¬ 
nent is contained in an Access Method Support 

Vector List pointed to by the access method control 
block (acb). See VTAM Programming for more 
information about the acb. 

Program Update Tape 
(PUT) and Program 
Temporary Fix (PTF) 

Supply a list of any puts and ptfs that have been 
applied to your system. Also, supply a list of 
changes that have been applied to the hardware, 
such as reas and ecs. 


If you have identified a module as the source of the 
problem, supply the ptf eyecatcher if the module 
has one. The ptf eyecatcher is the latest ptf 
number that has been applied to a module. It 
follows the module id in a dump. 


1 NetView is a trademark of International Business Machines Corporation. 
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Documentation 

Description 

List of Changes to the 
Network Configuration 

List any application programs, new devices, or 
new levels of the operating system you have 
added. 

Version/Release 

Number 

VTAM V3R1, V3R1.1, V3R1.2, or V3R2 

System Console/ Hard- 
Copy Log 

Shows all messages sent to or commands 
received from the operator. May provide clues as 
to when the system began to have problems. 

(vtam problems may not be apparent at the time 
they occur.) 

NetView or NCCF Hard- 
Copy Log (if using 

NetView or NCCF) 

Contains messages routed to NetView or to nccf 
that are associated with an operator terminal. 

NetView or NLDM File 
(if using NetView or 

NLDM) 

Contains session trace data for specified 
resources and session awareness data for all 
active sessions. 

Application Program 

Log (if appropriate) 

Some user-written operator application programs 
produce an application program log. 

VTAM Definition Library 

This is a set of definition statements for resources 

i 

in the vtam network, such as the application pro¬ 
grams and network nodes. The vtam definition 
library also contains the start options used to ini¬ 
tialize vtam, unless they were entered by the 
system operator. Detailed information about the 
vtam definition library is in VTAM Installation and 
Resource Definition. 

mvs vm LOGREC 

This is a data set (mvs) or file (vm) that contains 
records of various types of system failures, both 
hardware and software. For hardware failures, 
logrec entries contain sense and status informa¬ 
tion about the device causing the failure. For soft¬ 
ware failures, logrec entries contain information 
such as the psw, abend code, failing module name 
(when possible), and the general registers at the 
time of failure, logrec entries are written each 
time vtam produces a supervisor call (svc) dump. 

vseSYSREC 

The vse recorder file (sysrec) contains error 
records for devices owned by vtam. sysrec records 
are printed with the Environmental Recording. 

Editing, and Printing (erep) program. 
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Documentation 

Description 

Link-Edit Map 

mvs If a vtam load module is involved in a problem, 
an xref map of the load module is needed to show 
the location of other vtam modules within that load 
module. To get an xref map, use the service aid 
list (amblist) with the control statement listload 
and the parameter output = xref. This produces a 
listing showing the module (csect) names and 
their location within the load module. Specific 
information on how to use the list service aid can 
be found in the Service Aids book for your oper¬ 
ating system. 

viviSave the vtam lkedit, vscs lkedit, and vtammap 
files that are produced by the installation proce¬ 
dure for vtam and vscs. 

vsEMost vtam modules are link-edited into mul¬ 
tiple csect phases. In some cases, it may be nec¬ 
essary to determine where within the phase a 
failing module is loaded. To do this you must have 
the link-edit map for the phase. Save the output 
from the initial installation steps for vtam, as well 
as Maintain System History Program (mshp) 
linkage editor output from the application of main¬ 
tenance to the system. 

Symptom String 

Some vtam routines provide a symptom string after 
a failure. 

mvs vMThe symptom string is put in the system 
diagnostic work area (sdwa), which is printed by 
erep as part of the logrec entries. For more infor¬ 
mation on logrec, see: 

mvs SYS1 .LOGREC Error Recording 

vm OLTSEP and Error Recording Guide. 

vsEThe symptom string is put in the first records at 
the beginning of the svc dump, usually on the first 
page. 

r/ivsLink Pack Area 
(LPA) Map 

Contains module names and starting addresses of 
modules in sysi.lpalib. To get an lpa map, use the 
ibm service aid list (amblist) with the control state¬ 
ment listlpa. Specific information on how to use 
the list service aid can be found in the Service 

Aids book for your operating system. When used 
with a link-edit map and a dump, an lpa map will 
enable you to identify a module that is found at a 
specific address within the link pack area. 


LY30-5601-1 ©Copyright IBM Corp. 1984, 1989 


Chapter 1. Documentation to Collect for All Problem Types 5 




“Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


What is the Problem Related to? 

Symptoms are often related to a particular device, command, or update to the 
system. If you suspect this is so, you should tell the Support Center of this relation¬ 
ship. Here are some possible relationships and the kind of documentation you 
should have for each one: 


APAR or PTF Number 

If the problem appeared after you applied an apar fix, supply the apar number. If 
the fix was a ptf, supply the ptf number. The format of apar numbers and ptf 
numbers in each operating system is shown below: 


Operating 

System 

APAR 

PTF 

MVS 

OYnnnnn 

UYnnnnn 


OZnnnnn 

UZnnnnn 

VM 

VMnnnnn 

UVnnnnn 

VSE 

DYnnnnn 

UDnnnnn 


Device Type 

If the problem is associated with the use of a particular type of terminal or other 
hardware unit, supply that device type (such as 3278 Model 2). If the problem is 
associated with a particular type of communication link, supply appropriate link 
characteristics, such as sdlc, bsc. sna or non-SNA. Also, identify any recent micro¬ 
code activity on the control units involved. 

Operator Command 

If the problem is associated with a particular vtam operator command, supply the 
full command name (such as vary). Also, note any command operand (such as 
inact) or a network node type (such as cdrm) that has been definitely associated 
with the problem. 


Terminal User Action 

If the problem is associated with a particular terminal user action, such as ibmecho, 
uss logon, or pressing the clear key, describe the user action (or sequence of 
actions). 

VTAM Application Program 

If the problem is associated with a vtam application program that is an ibm licensed 
program (such as cics or tso), supply the name of the licensed program. 
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Hardware Error Condition 

Sometimes it is immediately apparent that a problem is related to a specific hard¬ 
ware error condition. The hardware error might have been detected and reported 
in several ways: 

• By an operating system message 

• By a vtam or application program message 

• By the system operator 

• By a terminal user (an indicator of the error status appears in the operator 
information area, at the bottom of the terminal screen) 

• By a vtam buffer filling up with identical information from one device 

• Through logrec 

• Through sysrec or rms. 

If a hardware error occurred, note the failure condition that accompanied it, such 
as UNIT CHECK Or TIMEOUT 

Note: The ibm Support Center cannot help you with hardware problems. Try to 
solve the problem locally. Use NetView or npda if you have it installed, or use the 
system console message, which identifies the affected subarea. If you still need 
help, contact your branch office. 


Coding Change 

The problem may have occurred after a coding change in: 

• vtam network definitions 

• Macro usage 

• Start options 

• User-coded exit routines 

• Job control statements. 

If so, supply the macro, the option, and the value specified. Examples are: 

• luname lu pacing - i on an ncp lu definition statement 

• simlogon optcd = (any.Q) on an api macro. 
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Documentation for Hardware Failures 

If you think your problem is related to a hardware failure, use the following tools to 
collect information about the hardware failure: 

• sdlc link level 2 test (For more information on the LL2 test, see “Modify SDLC 
Link Level 2 Test” on page 271.) 

• ncp intensive mode error recording (For more information on intensive mode 
recording, see “Modify NCP Intensive Mode Recording” on page 271 and the 
NCP, SSP, and EP Diagnosis Guide.) 

• NetView or npda, if you use it in your system 

• logrec (or similar operating system facilities) 

• vshSysrec (or similar operating system facilities). 


Recommendations 

For your problem to be serviced more efficiently: 

• When vtam messages are symptoms of a problem and your installation has 
written its own version of a vtam message, supply the original vtam message 
when you report the problem. 

• When vtam or operating system messages are symptoms of a problem, follow 
the recommendations in the appropriate message book. 

• Use the available formatting routines for dump and trace output instead of 
unformatted hexadecimal output. 

\ i For machine-readable dumps, use the interactive problem control sub¬ 
system (ipcs), if you have it installed, to format and print the output. You can 
use ipcs to look at the dump online. 

You can also use the following utilities to format and print a dump: 

- 1., AMDPRDMP 

- IKJEFTG1 

- PRTDUMP 

DOSVSDMP. 

For vtam and ncp trace data, use one of the following to format and print the 
output: 


- . tap or prdmp 
TAP or TRAPRED 

- TAP or TPRINT. 

See “Printing Trace Records” on page 223 for more information about these 
trace formatters. 
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• Keep on hand supporting documentation that may apply to most problems. 
This includes: 

- Listings of the vtam tables your installation has defined, such as uss and 
LOGMODE 

- Listings of vtam application programs and vtam exit routines 

- A table of destination subareas, explicit route numbers, virtual route 
numbers, paths, and transmission groups 

- Outboard recorder (obr) records and miscellaneous data records (mdrs) 
describing network hardware errors. (For more information on these 
records, see “Hardware Error Recording” on page 300.) 

- A table associating session types, cos names, and cos tables 

- A listing of vtam components, as follows: 

mvs A System Modification Program (smp) configuration data set (CDS) 
for vtam and tso/vtam components (see the SMP book for information 
about smp) 

vm Save the vtam lkedit, vscs lkedit, and vtammap files that are 
produced by the installation procedure for vtam and vscs. 

vse A Maintain System History Program (mshp) retrace listing for vtam 
components (see the MSHP book for information about mshp) 

• Keep a current list of the network's physical configuration. 

• If you encounter problems during network activation after installing vtam or 
changing the network, simplify your operating procedures to a step-by-step 
approach. Use appropriate trace facilities and the vtam display command to 
monitor the process. 

• mvs vm If your configuration is using sna network interconnection and you are 
using alias names, keep a list of the alias names defined to each name trans¬ 
lation program. 

• If you are using NetView or nldm, collect session-related data for same- 
network and cross-network sessions. To identify the first occurrence of a 
problem, NetView or nldm should be running all the time. 

NetView and nldm collect two kinds of session data: session awareness data 
and session trace data. 

NetView and nldm collect session awareness data for all active sessions. 
Session awareness data includes: 

- Session type 

- Names of session partners 

- Session activation status 

- ids of subarea physical units contained in the explicit route assigned to the 
session 

- Transmission group numbers 

- Addresses and network ids of sscps that own links in the transmission 
groups. 
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Session trace data is recorded only for sessions with a resource for which a 
session monitor or nldm session trace has been started. It includes: 

- Session activation parameters 

- vtam piu data 

- ncp data. 
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Chapter 2. Classifying the ProbleirTs Symptoms 

This book contains diagnosis procedures for vtam, tso/vtam (mvs only), and vscs 
(vm only). For other types of problems (such as operating system, ncp, application 
program, and hardware problems) see the list of appropriate books in 
“Bibliography” on page 671. 

If any of the following caused your problem, this book may not help you: 

• Did you modify an application program that has run without problems in the 
past? 

• Did you change the processing environment? For example, did you introduce a 
new host processor or communication controller? 

• Did you modify the operating system, or did you install a new release of the 
operating system? 

• Did you add a new terminal to your vtam network that had incorrect features or 
incorrect Request for Engineering Activity (rea) and Engineering Change (ec) 
level? 

• Did attaching a link cause the problem? 

• Did setting switches at a terminal cause the problem? 

• Did initializing link parameters for a programmable controller cause the 
problem? 

• Did you modify installation-provided vtam tables? For example, did you modify 
logmode, cos, or uss tables? 

• Did modifying vtam messages cause the problem? 

This book does not address problems caused by these user activities. You need to 
resolve the problem on your own. 

Note: If you cannot resolve the problem on your own, and if one of the user actions 
listed above resulted in one of the symptoms listed in “Symptom Listing” on 
page 14, follow the appropriate instructions in Chapter 3, “Procedures for Specific 
Problem Types” on page 19 to gather additional information, then call the ibm 
Support Center for assistance. 
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Symptom Listing 


Find the symptom you are experiencing in the following list. The symptoms are listed alphabetically. 
Match your symptom to the appropriate vtam problem type, and turn to the page indicated. If none of the 
symptoms matches yours exactly, choose the one that is most similar. 


Symptom 

Problem Type 

See 

Abend message 

Abend 

Page 19 

Activating network nodes takes too long 

Performance 

Page 62 

Application program cannot terminate 

Wait 

Page 29 

Application programs and terminals cannot communicate 

Wait 1 - 

Page 29 

Application program reports an unexpected return or sense code 

Incorrect Output M 

Page 57 

Batch application program fails to complete 

Wait 

Page 29 

Book contains information that is wrong or ambiguous 

Documentation 

Page 66 

Book is missing information 

Documentation 


Books contradict each other 

Documentation 

Page 66 

Command is not completed 

Wait '0 


Commands cannot be entered on system console 

Loop 

Page 46 

Commands take too long to complete 

Performance 

Page 62 

Cursor is in the wrong position 

Incorrect Output DEF 

Page 57 

Deactivating network nodes takes too long 

Performance 

Page 62 

DTI error message 

Message 

Page 53 

DTI message is wrong or formatted improperly 

Message 10 

Page 53 

Dump file contains a VTAM, TSO/VTAM, or VSCS dump 

Abend 

Page 19 


or 

Program Check 

Page 25 

Error message 

Message 

Page 53 

X'FFF 1 , X'FFB', or X'FED' appears 

Program Check 10 

Page 25 

Hung session 

Incorrect Output 

Page 57 


M This may also be a message problem. 

<- This may also be a loop problem. 

10 This may also be incorrect output. 
h This may also be a hardware problem. 

def This is probably an application program or vtam definition error, such as using an incorrect logmode definition. 
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Symptom 

Problem Type 

See 

Hung system 

Wait L 

Page 29 

IKT error message 

Message 

Page 53 

IKT message is wrong or formatted improperly 

Message 10 

Page 53 

Initialization problem (VSCS only) 

Chapter 5 

Page 93 

Internal error message (VSCS only) 

Chapter 5 

Page 93 

1ST error message 

Message 

Page 53 

1ST message is wrong or formatted improperly 

Message 10 

Page 53 

IST252I message appears 

Program Check 

Page 25 

IST413I message appears 

Abend 

Page 19 

Keyboard locks unexpectedly 

Incorrect Output 

Page 57 

Logo problem 

Incorrect Output 

Page 57 

LOGON takes too long to complete 

Performance 

Page 62 

LOGREC entries indicate an abend 

Abend 

Page 19 

LOGREC fills with repeated entries 

Loop H 

Page 46 

Message is wrong or formatted incorrectly 

Message 10 

Page 53 

Message from application program 

Incorrect Output M 

Page 57 

Message is sent to the wrong console 

Incorrect Output 

Page 57 

Message repeats continuously 

Loop 

Page 46 

Message text does not explain a condition 

Message 

Page 53 

Message is missing text 

Message 10 

Page 53 

Output data is formatted incorrectly 

Incorrect Output 0EF 

Page 57 

Performance is degraded after a network outage 

Performance 

Page 62 

Printers stop 

Loop 

Page 46 

Program check message 

Program Check 

Page 25 

PSWs point to a VTAM address 

Loop 

Page 46 

Response time is slow 

Performance 

Page 62 

Routing information is wrong 

Incorrect Output 

Page 57 

SYSREC entries indicate a program check 

Program Check 

Page 25 

SYSREC fills with repeated entries 

Loop H 

Page 46 

System functions stop 

Loop 

Page 46 

System light is on, Wait light is off 

Loop 

Page 46 

Tapes stop 

Loop 

Page 46 
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Symptom 

Problem Type 

See 

Terminal user cannot enter data 

Incorrect Output 

Page 57 

Terminal user cannot log on or off 

Incorrect Output 

Page 57 

Terminal user gets unexpected response 

Incorrect Output DEF 

Page 57 

Terminal user reports incorrect or missing data 

Incorrect Output DE,: 

Page 57 

Termination problem (VSCS only) 

Chapter 5 

Page 93 

Traffic ceases through a network component 

(BSC link, SDLC link, communication controller, control unit) 

Wait 

Page 29 

VTAM does not work as described in a book 

Documentation 

Page 66 

VTAM is not communicating with system console 

Wait 1 - 

Page 29 

VTAM process issues an error message 

Message 

Page 53 

“5” error message 

Message 

Page 53 

“5” message is wrong or formatted improperly 

Message 10 

Page 53 

5C52I message appears 

Program Check 

Page 25 
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Chapter 3. Procedures for Specific Problem Types 

mvs vm Abnormal End Procedure.19 

vse Program Check Procedure .25 

Wait Procedure .29 

Checking Whether the VARY INACT,FORCE Command Can Complete .44 

Loop Procedure .46 

Message Procedure .53 

Incorrect Output Procedure .57 

Performance Procedure .62 

Documentation Procedure .66 

Failing Module Procedure .67 

Reporting Procedure .68 
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Abend Procedure 


Chapter 3. Procedures for Specific Problem Types 

Now that you have classified your problem as a specific type, this chapter shows 
you how to collect the additional information you need when you talk with the ibm 
S upport Center. 

Turn to the section that describes your particular problem type: 

• “mvs vm Abnormal End Procedure” 

• “vse Program Check Procedure” on page 25 

• “Wait Procedure” on page 29 

• “Loop Procedure” on page 46 

• “Message Procedure” on page 53 

• “Incorrect Output Procedure” on page 57 

• "Performance Procedure” on page 62 

• “Documentation Procedure” on page 66. 

There are two other sections at the end of the chapter: 

• “Failing Module Procedure” on page 67 tells what to do when you have iso¬ 
lated the problem to a specific vtam module. You may be sent to this section 
from within the procedure for the problem type you have chosen. 

• “Reporting Procedure” on page 68 describes briefly how to report the problem 
to the ibm Support Center. 


M vs vm Abnormal End Procedure 

If the problem is an abend, use the procedure in Figure 3 on page 20 to collect 
the following documentation: 


• Dump output 

• LOGREC 

• Symptom string 

• Abend or system completion code 

• Contents of the general registers (at the time of the abend) 

• Module id and ptf eyecatcher 

• psw (at the time of the abend) 

• vit if available at the time of the abend. 
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Figure 3. mvs vm Overview of the Abend Procedure 

Detailed descriptions of the steps involved in the abend procedure begin below. 

1. Get dump output. 

vtam usually produces a dump for an abend. If no dump was taken, the dump 
files or spools may be full. Check for a message that an error occurred while 
vtam was trying to produce the dump. If vtam was not able to complete the 
dump, you will have to re-create the abend or wait for it to occur again. 
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Abend Procedure 


2. Find the symptom string. 

A symptom string is a structured data base search argument. The symptom 
string gives information about what was happening at the time of the abend. A 
record is written to the logrec data set whenever vtam takes a supervisor call 
(svc) dump. For about 85% of all abends, recovery routines produce a 
symptom string subset, which you can get by printing logrec. The symptom 
string subset, if it occurs, is located in control block sdwa in logrec. 

mvs The sdwa address should be listed in the beginning of the dump, in the 
dump abstract information. It is also printed out in logrec, labelled “Hex 
Dump of Record” at the end of each software entry. 

The symptom string begins at X'194' in the sdwa. Field sdwaural gives the 
length of the symptom string, which can be up to 256 bytes. 

vm There are three ways to find the symptom string: 

a. If vit is active, locate the abnd snap trace record. This shows the address 
of the sdwa. 

b. If vit is not active, scan the registers shown at the beginning of a dump for 
the address of the sdwa. 

The sdwa can be difficult to recognize. However, the abend code is at + 
X'4\ so knowing the abend code before you start looking for the sdwa can 
help. 

c. If neither the trace nor the dump is available, scan the software error 
portion of logrec for the symptom string. 

Figure 4 shows an example of a symptom string subset. This example is from 
the comments section, to the right of the sdwa. 

AB/S00C4 PIDS/566528901 LVLS/113 RIDS/ISTCFCWM 
RIDS/ISTAPCES#R RIDS/ISTCFCR2#L REGS/GR14 FLDS/PSW ADRS/G00006C4 
VALU/HB0Q44770 FLDS/POWPSSQ ADRS/027F9CB0 REGS/0C6A2 REGS/0AQ18 
VALU/HE0044770 PIDF/5665289Q1 PTFF/UY09850 PRCS/G000001Q 

Figure 4. Example of a Symptom String Subset in Output 

The meanings of the fields are given below, in the order in which they occur in 
the example. 

ab Abend interrupt code, such as 0C4. 
pids vtam component id. 

lvls vtam version and release level. 

rids One of three kinds of modules: 

• Recovery module, if followed by .R 

• Load module, if followed by .L 

• csect name of the failing vtam module, if not followed by anything. 

regs The first byte shows the register number, and the next 1.5 bytes show 
the displacement. The displacement value is the difference between 
the value of the psw 1-Address and the content of the register. Each 
regs field is shown only if the value is less than the psw, and if the dif¬ 
ference is less than 4K. 
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flds Fields, control blocks, and dsects labels 
adrs Offset into the failing vtam module. 
valu Field value or overlay length 
pidf Software program component id 
ptff vtam service level. 

prcs Return code 

3. Find the abend or system completion code. 

mvs You can find the system completion code in the output of several different 
service aids. The mvs system control block rtm2 work area (RTM2WA), the 
sysi.logrec software record, and the Task Control Block (tcbcmpc) contain the 
completion code. The RTM2WA is pointed to by the tcb of the failing task (field 
tcbrtwa), and is listed after the abending tcb. 

vm You can find the abend code, abncode, in the abend work area, abnwa. Low 
coreX'298' points to the abnwa. You can also find the system completion 
code in the sdwa in a dump, or you can use the tactive subcommand of the ipcs 
dumpscan command to display the task completion code. 

4. Is the abend code OCx? 

If the completion code is of the form OCx (where x = the program interruption 
code from the psw), continue with this step. If the abend code is not OCx, go to 
step 6 on page 23. 

a. Find the program status word (psw) at the time of the abend. 

The psw is found in: 

• mvs The logrec output, the sdwa, or the RTM2WA 

• vm The logrec output, the sdwa, or the abnwa. 

The location of the psw in the dump output varies depending on the type of 
dump taken. For assistance in locating the psw in dump output, see the 
diagnostic books for your operating system. 

b. Find the failing address. 

The psw contains either the address of the next instruction to be executed 
at the time of the abend or the instruction that failed at the time of the 
abend, depending on the interruption code. Scan the dump output to find 
the address given in the psw 

If you cannot find the address, the dump may not contain the relevant 
portion of main storage. 

c. Find the module id containing the failing address. 

vtam identifies modules with the module name, Julian date, and ptf 
eyecatcher at or near the beginning of each module. This module identi¬ 
fier will be in the form: 

IST xxxxx yy.ddd nnnnnnn 

where xxxxx is the last five characters of the module name, yy.ddd is the 
Julian date the module was assembled, and nnnnnnn is the latest ptf (if 
any) that has been applied to this module. 

Sometimes vtam puts the module name of the failing module in logrec. If 
it is not there, you can find it in a dump. 
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To find the module id in a dump, start at the failing address and scan in 
descending address order along the right side of the listing. The module id 
is printed in ebcdic. 

.iv: You can also scan the lpamap for the name of the module that contains 
the failing address. 

d. Find the failing instruction. 

Use the address in the psw to find the instruction that caused the abend. 

e. Find the general registers. 

The general registers in use at the time of the abend are found in: 

• The logrec output, the sdwa, the abend svrb register save area, or 

the RTM2WA 

• The logrec output, the sdwa, the abend svrb register save area, or 
the ABNWA. 

Use the diagnostic books for your operating system to help find the regis¬ 
ters. 

f. Determine which register has invalid information. 

The failing instruction often uses a register with an invalid address in one 
of the general registers, or will point to an invalid location (for example, 
low-address storage). Use the Principles of Operation book for your 
processor, the program interruption code from the sdwa (for mvs) or from 
the psw (for vm), and the general registers used in the failing instruction, to 
determine (if possible) which register contains or points to incorrect data. 

If the interruption code is 10 or 11, then the psw address points to the 
failing instruction. Otherwise, back up the psw by the instruction length, 
and that is the failing instruction. 

Next go to step 9 on page 24. 

5. ws Is the abend code OAB, OAC, OAD, or 15D? 

These abend codes indicate a tso/vtam abend. For diagnosis information, go 
to “-M/? TSO/VTAM Abends” on page 77. 

6. Is the abend code OAx? 

If the abend code is in the form OAx, continue with this step. If not, go to step 7 
on page 24. 

a. Find the abend code explanation in VTAM Messages and Codes. 

An abend code of OAx indicates a problem within the vtam network. The 
problem could have originated in vtam, the ncp, an application program, or 
the hardware of some other network component. Look up the code in 
VTAM Messages and Codes. Most OAx abends place a return or reason 
code in register 15 at the time of failure. You can find the return code in 
register 15 by using the set of general registers from: 

• s The logrec output, the sdwa, or the rtm2wa 

• i The logrec output, the sdwa, or the abnwa. 
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b. Find the address of the module that issued the abend, using the psw, which 
points to svc 13 . 

c. Find the module id. 

From the address determined in the previous step, scan in descending 
address order through the dump to find the module id (see step 4c on 
page 22). 

Go to step 9. 

7. MVS Is the abend code 80A, 40D, or 202? 

If the abend code is one of these, continue with this step. Otherwise, continue 
with step 8. 

These abend codes indicate storage problems. Collect the following documen¬ 
tation: 

• A dump of the vtam address space 

• A dump of the vtam csa 

• LOGREC output 

• vit output at the time of the abend, if it is available. 

After obtaining this documentation, go to “Reporting Procedure” on page 68. 

8. Is the abend code none of the above? 

mvs A complete list of abend codes is found in the System Codes book for your 
operating system. 

vm The abend codes are in VM/SP System Messages and Codes. 

Each code has an explanation of the documentation required and the problem 
determination steps to follow. For example, many abends occur during exe¬ 
cution of svc instructions. Parameter lists and register contents passed to svc 
routines are in the diagnostic books for your operating system. These books 
may suggest that you obtain additional information such as a module name, a 
return code, a register containing invalid information, or the name of a system 
control block containing invalid parameters. After making a complete check of 
these sources, you are ready to report the problem; continue with step 9. 

9. Report or go to the failing module procedure. 

If you determined the module id, go to “Failing Module Procedure” on page 67. 
Otherwise, see “Reporting Procedure” on page 68. 
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vse Program Check Procedure 

If the problem is a program check, use the procedure in Figure 5 on page 26 to 
collect the following documentation: 


• Dump of vtam partition and supervisor 

• Message information 

• Contents of the general registers (at the time of the error) 

• Module id and ptf eyecatcher 

• psw (at the time of the error). 
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Figure 5. vse Overview of the Program Check Procedure 

Detailed descriptions of the steps involved in the program check procedure begin 
below. 

1. Get dump output. 

In the hard wait cases, use the formatting option to print the vse supervisor 
areas and the vtam partition. Since vtam programs are not executed in the 
shared virtual area (sva), it is not usually necessary to print the sva for vtam 
problems. 

If the dump was produced by the vse terminator upon cancelation of vtam, it 
will produce a dump of both the vse supervisor and the vtam partition (if // 
option dump.sysdmp was specified in the vtam procedure). A dump produced 
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using // option partoump will not contain all of the vse supervisor areas used in 
performing vtam functions. 

See the VSE Service Aids book for more information on obtaining and format¬ 
ting vse dumps. 

2. Find the symptom string. 

A symptom string is a structured data base search argument. The symptom 
string gives information about what was happening at the time of the program 
check. A record is written to the sysrec file whenever vtam takes an svc dump. 
For about 85% of all program checks, recovery routines produce a symptom 
string subset, which you can get by printing sysrec. 

Recovery routines produce the symptom string if storage is available for it. 

The symptom string subset, if it occurs, is located in the first records of the svc 
dump output, usually on the first page. Figure 4 on page 21 shows an 
example of a symptom string subset in dump output. 

3. Locate the point of failure. 

a. If the program check was reported by message 0S03i, the exception type 
and location are contained in the message text. 

b. For hard wait states (X'FFF' and X'FFB'), the failing instruction address 
can be determined from the program check old psw (see the VSE Service 
Aids book for the location of the psw in dosvsdmp format). 

c. For task termination messages other than 0S03I, find the save area con¬ 
taining the error psw and registers (in the beginning of the task termination 
dump). 

d. For message 1ST2521 (or 5CS2I, for vtam V3R1 or V3R1.2) with return code 36, or 
vse message ovosi, the canceled task is vtamrp, but the save area used is 
not the normal subtask save area. Instead, the vse program check handler 
stores the psw and registers at label svpcsave. 

e. For message IST 2521 (or 5 C 521 , for vtam V3Ri or V3R1.2) with return code 20, the 
vse dump of vtam will be taken under the main task. Locate the vtamrp 
save area either by finding itsTCB in the vse supervisor dump or by using 
location 10 to find the atcvt and field atcflda to locate module istincfo, 
which contains the save area. 

Identify the save area by the name vtamrp in the first 8 bytes. This is the 
save area of the routine that generated the dump. 

The save area identified by the jobname in the next 8 bytes contains the 
PSW and registers of the failing task. 

f. For wait state X'FED', use the address in register 5 as a failure address. 

4. For waitfff and waitffb, determine if the failure is in the vse supervisor. 

Though the cause of the problem may not lie in vtam, there are several things 
to consider in making that determination. 

a. Check the vse supervisor listing and include the label preceding the point 
of error in your information for the Support Center. If the logic pertains to 
a vtam function, the problem may be in vtam. 

b. If the instructions have been overlaid by data, try to identify that data from 
its contents, and note where the overlay begins and its length. If the 
overlay contains terminal data or a recognizable vtam control block, the 


LY30-5601-1 ©Copyright IBM Corp. 1984,1989 


Chapter 3. Procedures for Specific Problem Types 27 



Program Check Procedure 


“Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


problem is probably in vtam. Save any pertinent information about the 
overlay to discuss with the ibm Support Center. If the overlay is deter¬ 
mined to be a vtam control block, the name should be given to the Support 
Center. 

c. If the last interruption was a vtam svc 49 or svc 53 , add that to the informa¬ 
tion in the form svcxx. 

If the last interruption was some other vse svc issued by vtam, then vtam 
may be issuing the svc incorrectly. Add that information in the form svcxx. 

Proceed to step 5, using the address in the svc old psw as the failure 
address. 

d. If the last interruption was an i/o interruption from a VTAM-owned channel- 
attached device, the problem may involve one of the vtam appendage rou¬ 
tines. 

e. For the ffb condition, try to determine what was being referred to that 
caused the page fault. If the exception address at location 90 points to an 
area in the vtam partition, the problem may be in vtam. If the address is 
within a vtam module (appears to be executable code), identify the module 
as in step 6. If not, try to identify it as a vtam control block, using the list of 
control block ids in Appendix E, “Storage and Control Block ID Codes” on 
page 657. If successful, add the control block name to your list of doc¬ 
umentation. If not, the area should be either in a vtam module (see step 6) 
or in a vtam buffer pool (see Appendix A, “Finding VTAM Buffer Pools"). 

5. Determine which register contains or points to incorrect data. 

The failing instruction normally has an invalid address in one of the general 
registers, or points to an invalid location (for example, low storage). Use the 
Principles of Operation book for your processor, the program interruption code 
from the psw, and general registers in the failing instruction to determine (if 
possible) which register contains or points to incorrect data. Add this register 
number string in the form REGnn to the information for the Support Center. 

6. If the falling instruction address found in step 3 on page 27 is in the vtam parti¬ 
tion, identify the failing vtam module. 

Most vtam modules are identified by a field containing the name istxxxxx and 
the Julian date near the beginning of the module (for example, istaccq4 86 . 175 ). 
To locate this identifier, scan the dump in descending address order from the 
point of failure. The identifier will be printed in ebcdic along the right-hand 
side of the dump. Add the module name to your documentation list. Go to the 
“Failing Module Procedure” on page 67 to continue obtaining information for 
the Support Center. 

7. Report or go to the failing module procedure. 

If you determined the module id, go to the “Failing Module Procedure” on 
page 67. Otherwise, goto “Reporting Procedure" on page 68 for information 
on contacting ibm. 
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Wait Procedure 


If the problem is a wait, use the procedure in Figure 6 on page 30 to collect the 
following documentation: 


• i/o trace output 

• Buffer contents trace output 

• Session trace data (if using NetView or nldm) 

• Session awareness data (if using NetView or nldm) 

• Dump output: 

- >Mvs Dump of the vtam address space and csa 

- VM Dump of the vtam virtual machine 

- vse Dump of the vtam partition and vse supervisor 

• List of: 

- Waiting Process Anchor Blocks (pabs) 

- Waiting Request Elements (wres) and associated event ids (eids) 

- Waiting Request Parameter Headers (rphs) 

• For problems associated with an application program: 

— Output from the vit (all options except lock) 

- rpls or fmcbs queued to the acdeb 

• For problems associated with the network: 

- Output from line trace, generalized piu trace (gpt), transmission group (tg) 
trace, or (for 3720, 3725, and 3745 only) the scanner interface trace (sit). 

- vse Dynamic trace of communication adapter (if available) 

- ncp, moss, or csp dump 

- Reports from NetView, nccf, npda, imr, or erep (if available) 

Note: Use the documentation you have available, unless you need to re-create the 
problem. In that case, make sure the above traces are active. 
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Figure 6. Overview of the Wait Procedure 

Detailed descriptions of the steps involved in the wait procedure begin on page 31. 
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1. Determine the extent o! the wait condition. 

Determine how extensive the wait state is in the operation of the vtam network. 
Determine whether all vtam processing stopped or only processing with 
respect to a single device, or something in between. Also determine what, if 
any, recovery action was taken at the time the wait was encountered by the 
operator or user. Some information about the activity that immediately pre¬ 
ceded the wait may be available on the system log or in application program 
transaction logs. 

2. Did a logon, logoff, or command fail to complete? 

If so, continue with this step; otherwise, go to step 3 on page 32. 

a. If the wait condition was actually the failure of a vtam procedure to com¬ 
plete, use the display id command to identify the status of vtam resources at 
the time of the problem. Note any status codes that are abnormal. 
(Resource status codes are explained in VTAM Messages and Codes.) 

b. Use the vtam display pending, display sessions, or modify iopd commands to 
identify i/o requests for which vtam is awaiting a response from a network 
node. Sometimes a network node appears in a pending state awaiting the 
completion of activity at a higher- or lower-level node (for example, psubi. 
ptrm 2 ). The pending status on the other node is needed in such a case. 

c. Use the vtam display bfruse command to get information about vtam buffer 
pools. Save the output for use later in this procedure. 

d. A vtam operator may have attempted a recovery action (such as issuing a 
vary inact,force command; “Checking Whether the VARY INACT,FORCE 
Command Can Complete" on page 44 shows how to determine whether 
this command completed.) If the recovery action did not reset the state of 
the node for which the original command was issued, note any lack of 
change to the node status. 

e. If vtam is waiting for an i/o response, look at the output of the vtam buffer 
contents trace (assuming it was active when the problem occurred). If the 
trace shows that vtam did send a request and is expecting a response, the 
problem is probably in another network node. 

f. You can get additional information on the status of a command from the 
vtam Internal trace (vrr). With the sscp and piu options, you can match 
requests and responses and determine any requests that are outstanding 
(that is, for which responses have not been received). The sms option sup¬ 
plies information about resource usage, and the pss option provides infor¬ 
mation about vtam's scheduling of the dispatching process. (See 
Chapter 8, “Using the VTAM Internal Trace” for a description of the 
internal trace entries.) 

At this point you may have enough documentation to report the problem to the 
Support Center. If so, go to “Reporting Procedure” on page 68. Otherwise, go 
to step 5 on page 35. 
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3. Is network traffic stopped through a specific node? 

If so, continue with this step. Otherwise, go to step 4 on page 33. 

a. Add the specific node type to your problem documentation. For example, 
the node could be a 3705, a 3720, a 3725, a 3745, a 3790, or a 3274. 

NetView, npda, and erep facilities show whether errors have been recorded 
for the node in question. Session trace data (collected by NetView or nldm) 
shows whether the node is not responding to vtam, or whether vtam is dis¬ 
carding the responses. Consider using ncp intensive mode recording (imr) 
for recurrent problems of this type. 

b. Note any messages on the system or NetView command facility log 

reporting er-inop outages or other failures. Use the vit trace, or use the i/o 
trace with the every operand, to trace the network flow up to the point of 
failure. NetView, npda, mvs vm logrec, and vse sysrec show the reason for 
the inop. 

c. For NCP-related problems, use the line trace or generalized piu trace if the 
affected node is in an adjacent subarea. Use the transmission group trace 
to record intermediate node flows up to the point where the problem 
occurred. 

d. If the problem may be in ncp software or communication controller hard¬ 
ware, obtain a dump of ncp storage. If the wait affects only part of the 
network, use the dynamic ncp dump facility. It allows the rest of the 
network to continue operating while the dump is taken. If the failure 
requires reactivating the ncp, use the modify dump command. (See 
“Network Control Program (NCP) Dump” on page 274 and the NCP , SSP, 
and EP Diagnosis Guide for more information on ncp dumps.) 

If the ncp is hung, or the hung resource is attached downstream of an ncp, 
see the NCP, SSP, and EP Diagnosis Guide for information on hung 
resources. 

e. vse If the problem is in a device attached to the communication adapter, 
use the dynamic trace of the communication adapter to obtain information 
about line-related errors. See VSE Service Aids for more information on 
this trace. 

f. If the problem is in a channel-attached device or a channel-to-channel 
attachment, examine one of the following traces, if available, to determine 
the sequence of events preceding the wait. (If no trace output is available, 
you will have to re-create the problem to get it.) 

• vit trace with the cio option 

• MVS CCWTRACE 

• vse sdaid i/o and ccwd traces 

• vm cptrap sio and i/o trace 

• vm cp virtual machine trace with i/o, sio, ccw, and csw. 
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The books listed below contain more information on operating system i/o 
control blocks: 

• MVS Service Aids and MVS Handbook 

• VM/SP System Programmer's Guide (for vm R4) 

• VM/SP Facilities for System Programming (for vm rs) 

• VSE Service Aids and VSE Handbook. 

g. If enough information is available, go to “Reporting Procedure” on 
page 68. Otherwise, go to step 5 on page 35. 

4. Is it a session or application program wait? 

If the wait condition appears to be related to a particular vtam application 
program, continue with this step. Otherwise, go to step 5 on page 35. 

a. Enter the display id command for the application program, using the every 
or scope = all operand. If there are any nodes with status act/u, re-enter 
the display command. If you are again informed that the status of a node is 
act/u, issue vary inact,force for that node. If you still have a wait condi¬ 
tion, continue with the next step. 

b. Find out if the problem is in vtam. If only one application program is 
waiting while others continue to communicate with vtam, that application 
program probably contains an error. To determine what caused the 
problem, obtain a dump of the application program and the operating 
system supervisor at the time of the problem. 

• Make sure that the error is not an operating system error. (Use the 
diagnostic books for your operating system.) 

• If possible, use the dump to determine the reason the application 
program is waiting. If the application program is not waiting for vtam, 
use the documentation for the application program to determine the 
reason for the wait. If the problem is in tso/vtam, go to 

Chapter 4, “mvs Procedures for TSO/VTAM Problems.” If the problem 
is in vscs, go to Chapter 5, “vm Procedures for VSCS Problems.” 

c. If vtam still seems to be the cause of the problem, you will need output 
from the vtam internal trace (vit) to obtain a record of activity on the failing 
session. (If the vit trace was not running at the time of the failure, you 
should re-create the problem with the vit active.) 

• If all application program sessions are hung, a small amount of trace 
data will be produced, and you can collect it all with mode = int. 

• If only part of the network is affected, a large amount of trace data may 
be produced, and mode = ext is recommended. 

See Chapter 8, “Using the VTAM Internal Trace” for more information on 
using the internal trace. You may also use the i/o or buffer contents traces 
with id = application program name specified. 

d. Find the address of the vtam acdeb for the application program, or the 
address of the vtam appcb for lu 6.2 applications. 

You can find an acdeb or appcb associated with an application by using the 
SES(applname) option of vtammap. If vtammap can not be run then all 
acdebs are queued out of the atcvt from the field atcacda. Sorry, there is 
no chain of appcbs. 
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e. For lu 6.2 applications using the appccmd interface, go to step 4f on 
page 35. 

For non-Lu 6.2 applications, continue with this step. 

1 ) Use the acdeb's address to find it in the dump. 

On the fmcb receive any queue, acdrafq points to the first fmcb. 

On the rpl receive any queue, acdrarq points to the first rpl. 

Notes: 

a) If there are fmcbs (acdrafq / 0), but no rpls (acdrarq = 0), a 
problem has prevented the application program from issuing 
receives. 

b) If there are rpls (acdrarq # 0), but no fmcbs (acdrafq = 0), there 
may be a problem involving the continue any/continue specific 
(ca/cs) state of the session. (See VTAM Programming.) 

2) Get the lucb address (field acdlucba in the acdeb). 

3) Get the address of a chain of fmcb extensions (field lucfmcba in the 
lucb). Each fmcb extension represents one lu-lu session. 

4) Each fmcb extension contains a pointer (field tspfmcba) to the address 
of an associated fmcb. Find the fmcbs associated with hung sessions. 

5) In those fmcbs, look for: 

• The ca/cs indicator (in tsppsfli and tsppsfl2) 

• The data queues (in tspaccum, tspewait, tspework, tspnwait, 

TSPNWORK, TSPEDATA, TSPNDATA, TSPTSOP, and TSPTSIP) 

• Session state flags (in tspsessr, tspdtsr, tspcrvsr, and tsprqrsr). 

6) Determine whether there are any indications of unusual conditions. 
(See VTAM Data Areas for more information on the fields in the fmcb.) 

Make a cross-reference listing of network addresses and node names 
to correlate the vit piu and 1/0 trace entries with vtam session control 
blocks, such as the lucb and fmcb. 

7) If enough information is available, go to “Reporting Procedure" on 
page 68. Otherwise, go to step 5 on page 35. 
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f. For the lu 6.2 applications using the appccmd interface: 

1) Use the appcb's address to find it in the dump. 

On the queue of rabs in continue any (ca) mode, apprbdat points to the 
first rab. 

On the rpl receive any queue, appranyq points to the first rpl. 

Notes: 

a) If there are rabs (apprbdat * 0), but no rpls (appranyq = o), a 
problem has prevented the application program from issuing 

RECEIVES. 

b) If there are rpls (appranyq * o), but no rabs (apprbdat = 0 ), there 
may be a problem involving the continue any/continue specific 
(ca/cs) state of the conversation. (See VTAM Programming .) 

2) Find the chain of rabs in the appcb (field apprabc). Each rab repres¬ 
ents a conversation. The session associated with the conversation is 
represented by a sab and is pointed to by rabsabpt. Find the rabs 
associated with hung sessions. 

3) In those rabs, look for: 

• The ca/cs indicator (in rabcmode) 

• The data queues (in rabndatq and rabconv) 

• The conversation state (rabpsfsm). 

4) Determine whether there are any indications of unusual conditions. 
(See VTAM Data Areas for more information on the fields in the rab.) 

Make a cross-reference listing of network addresses and node names 
to correlate the vit piu and 1/0 trace entries with vtam session control 
blocks, such as the rab. 

5) If enough information is available, go to “Reporting Procedure 1 ' on 
page 68. Otherwise, continue with step 5. 

See the NCP, SSP, and EP Diagnosis Guide for more information on hung ses¬ 
sions. 

5. Examine system data areas. 

mvs If you have not already done so, obtain a dump of the vtam address space, 
csa, and lsqa. Find and analyze the task control blocks. (See Service Aids 
and the Debugging Handbook for information on locating the task control 
blocks. See Diagnostic Techniques for information on analyzing them.) 

vm If you have not already done so, issue #cp vmdump, with the appropriate 
options, to obtain a dump of the vtam virtual machine. 

vse If you have not already done so, obtain a dump of the vtam partition and 
vse supervisor. Find and analyze the task control blocks. (See the VSE Hand¬ 
book for information on locating the task control blocks. See VSE Service Aids 
for information on analyzing them.) 
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6. Check for waiting pabs. 

Look at the following pabs in the atcvt: 
atcitpab Internal Trace pab 

atccspab Configuration Services pab 

atcvdpab vary Definition pab 

atcpxpab Buffer Pool Expansion pab 

atcpupab Physical Unit Services dypab 

atcpuiop Physical Unit Services i/o dypab 

atclusrt Logical Unit Services Router dypab 

atcnspab No Sessions pab 

atcnospb Network Operator Services pab 

atcsspab Session Serialization pab 

atctpmpb tp Message pab 

atctrmpb Termination Subtask dypab 

Check the contents of the pabweqp and pabrpha fields. The field pabweqp in 
each pab contains the address of a chain of work elements that have not been 
processed by vtam. The field pabrpha in each pab contains the address of an 
rph that is either running or waiting. Note the contents of these fields in each 
of the pabs, and have this information available when you contact IBM. 

Figure 7 on page 37 shows how to find each of these fields. 

Note: in some pabs, pabrpha may contain the address of an rph, even though 
the rph is not running or waiting. 
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ATCVT 

SSCP DYPAB, Session Services PAB 
Configuration Services PAB 
VARY Definition DYPAB 
PU Services DYPAB 
PU Services I/O DYPAB 
LUS Router DYPAB 
Termination Subtask DYPAB 


Work Elements 



Figure 7. Finding PABs Using the ATCVT 
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7. Is the wait caused by pending i/o? 

a. Use the Input/Output Problem Determination (iopd) facility to detect and 
report to the operator i/o operations that have been pending longer than a 
user-defined time limit. (For more information on using iopd, see “Modify 
Input/Output Problem Determination” on page 270 and VTAM Operation.) 

When a vtam process is waiting for a response, the process is represented 
by a waiting request element (wre) queued to an i/o locked queue anchor 
block (lqab). The wre points to an event id (eid), which indicates the 
reason for the wait. (Wait state event ids are described in VTAM Messages 
and Codes.) 

b. Look for the wres and corresponding eids in a dump by using Figure 8 on 
page 39 and the following steps: 

1) Find the atcvt from low-storage address mvs X'408\vm X'200',orvsE 
X'10 1 . 

mvs If these low-address locations are not available in a dump, use the 
pointer in the cvt (CVTatcvt) to find the avt. Location X'00 1 in the avt 
points to the atcvt. 

2) Get the address of the sscp i/o lqab in field atciolqb. This is the 
address of the first lqab. There is one lqab for each subarea in the 
vtam network. The lqabs are contiguous in storage. To find the lqab 
for the next subarea, add X'10' to the address of the previous lqab. 

To find an lqab for a particular subarea, multiply the subarea number 
by X' 14'. Add the result to the address in atciolqb. 

3) Scan each lqab at offset X'00' (field lqabfrst) for a non-zero address. 

This is the address of a wre. List these addresses if any are found. If 
a wre is present, look at wre + X'04 1 (field wreque) for additional 
wres queued off the same lqab. Again list the addresses of any wres 
found. 

4) Find the waiting event, wres contain a code (wreidcd) that identifies 
the waiting event. Use explanations of wait state event ids in VTAM 
Messages and Codes to find the reason for the wait. The address and 
length of the waiting event are in the wre in fields wreidp and wreidl 
respectively. 

5) Find the lqab. For waiting events other than sscp i/o, there is only one 
lqab. Using the hex offsets in VTAM Data Areas , find each of these 
lqabs from pointers in the atcvt: 

• ATCLUSMQ 

• ATCMCQAB 

• ATCPULQB 

• ATCNOSQ 

• ATCSSLQB 

6) Look for wres chained off the lqabs. If a wre is found, list its address 
and find the associated eid. Use explanations of wait state event ids in 
VTAM Messages and Codes to find and list the reason for the wait. 
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7) For each wre found, examine the wredata field. This field may contain 
a cpcb operation code. If so, look in Appendix D, "CPCB Operation 
Codes" on page 645 to determine the function represented by the 
operation code. Have the function name available when you report the 
problem. (You can also use the iopd facility to determine the waiting 
event. This facility is described in “Modify Input/Output Problem 
Determination" on page 270.) 


ATCVT 




LQABFRST 



Figure 8. Waiting Request Elements 
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8. Find waiting rphs. 

The following steps give instructions for examining two kinds of wait condi¬ 
tions: (1) a process is waiting for a buffer, and (2) a process is waiting for some 
other resource. Both kinds of waiting processes are represented by request 
parameter header (rph) control blocks, but the rph is found in different 
locations for each type of wait condition. 

• Step 9 explains how to find rphs queued from a buffer pool control block. 
These rphs show that the buffer pool cannot supply the required buffers, 
and as a result, the process is waiting. Note which buffer pool cannot 
supply the required buffers. 

• Step 10 explains how to find rphs that indicate a waiting process. In this 
case, collect the documentation listed in step lOd on page 41. 

9. Find rphs queued from buffer pool control blocks. 

A buffer pool that has no available buffers can cause a wait state. There are 
many reasons for running out of buffers; for example, incorrect allocation in 
the vtam start options, a vtam programming problem, or an application pro¬ 
gramming problem. Use the display bfruse output obtained in step 2 on 
page 31, if you were able to get it, to analyze buffer pool usage. Otherwise, 
use Appendix A, “Finding VTAM Buffer Pools” to find the buffer pools and 
determine whether any have used all their available buffers. 

Examine locations mvs vm bpcbrpha and bpcbrphb or location vse pcbfrpha in 
each buffer pool control block. If a non-zero address (indicating a waiting rph) 
is found at these locations, list the name of the buffer pool associated with that 
buffer pool control block. 

Also, follow the chain at offset X'04' into the rph to obtain the addresses of 
other rphs waiting tor the same pool. 

10. Find other waiting rphs. 

Waiting rphs indicate a vtam process that has not been completed. To locate 
the waiting rphs, look at a formatted dump (in mvs and vm) or search the large 
pageable buffer pool (lpbuf) by hand. 

mvs Use the vtammap dump formatter with the vtbasic option. This formats the 
component recovery areas cras, which contain the rphs. 

vm Use the prtdump command of ipcs and the vtbasic option. This formats the 
component recovery areas cras in a vm environment. 

If you cannot obtain a formatted dump, use Appendix A, “Finding VTAM Buffer 
Pools” to find lpbuf, and use steps 10a, 10b, and 10c to find the waiting rphs. 

a. Find each allocated buffer in the lpoo buffer pool. The lp buffer is allocated 
if the high-order bit of the second word is on. Scan each allocated buffer 
for a waiting rph. The buffer contains an rph if the value mvs vm X'016C' 
or vseX'0168' is shown at offset X'10' into the buffer (offset X'00 1 into the 
rph). When you see this value, look at location X'10' into the rph. A valid 
address at this location (not 1 or FFFFFFFF) indicates a waiting rph. This 
valid address is the rph resume address field (rphresum), the location at 
which a vtam routine will begin executing when posted. Write down the 
rph address and the resume address. 
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b. Find the remaining buffers in the buffer pool. Look for a waiting rph in 
each buffer as in the previous step. Continue with this process until the 
end of the buffer pool. If you find any more waiting rphs, add the rph 
address and the resume address to your documentation list. 

c. Next look for any rphs in the lpbuf expansion areas. 

(Appendix A, "Finding VTAM Buffer Pools” explains how to find the 
expansion areas.) If there are no expansion areas, go to step lOd. Other¬ 
wise, scan each expansion area for waiting rphs as in steps 10a and 10b. 
Continue adding waiting rph addresses and resume addresses to the list 
until you have examined all of the expansion areas. 

d. For each waiting rph, collect the following information: 

• Address of the rph 

• Resume address associated with the rph 

• Name of the module that contains the resume address 

• Starting address of the module in the dump 

• ptf number (if it exists) or the Julian date of the module 

• Any locks that this rph is waiting for (step 11 ). 

To find the name of the module that contains the resume address, start at 
the resume address and scan in descending address order (upwards) 
along the right side of the dump listing. The module id (including the Julian 
date and the ptf eyecatcher) is printed in ebcdic. 

11. Find rphs waiting for locks. 

a. For each waiting rph, look at the cralxptr fields. If any pointer (ptr) fields 
are non-zero, check the corresponding bit in cralkact. For example: 

• If craliptr is non-zero, look at the last bit in cralkact. 

• If cral2ptr is non-zero, look at the next-to-last bit in cralkact. 

• If cral3ptr is non-zero, look at the third-from-last bit in cralkact. 

If the corresponding bit in cralkact is off (zero), the rph is waiting for this 
lock. If the bit is on (non-zero), the rph is holding the lock and may be 
waiting for another lock. On your list of waiting rphs, add the name of the 
lock being held or waited for. (See Figure 9 on page 42.) 

b. If step 11a does not succeed, scan the lpoo buffer pool again, this time 
listing all allocated buffers that contain a non-zero value in field cralkact. 
This tells which rphs own locks, if any, and which locks are held. It is pos¬ 
sible for a cra to hold several locks. For example, a value of 06 indicates 
two locks being held: the rdtlock (04) and the voclock (02). (See Figure 9 
on page 42.) 

For each allocated buffer with a non-zero cralkact field, look at the 
cralxptr fields. (The buffer may or may not contain a resume address.) A 
non-zero pointer field contains a lockword address. Find the lockword. 

The first word of the lockword shows a queue of rphs waiting for that lock. 
Add these rphs to your documentation list. 

12. Report the problem. 

Go to “Reporting Procedure" on page 68. 
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Name 

Lvl 

Hex 

Value 

Control 

Block 

Field Name 

Number 

Function 

Applies to 

ADJLOCK 

5 

10 

Adjacent 

Subarea 

Table 

(ISTADJSA) 

ATCADJLK 

One 

Protects users of CIDCTL 
when adding or deleting 
an adjacent node. 

MVS, 

VM, 

and VSE 
Pre-V3R2 

DEBLOCK 

5 

10 

ACDEB 

ACDLOCK 

One per 
OPEN 
applica¬ 
tion 

program 

1. Protects FMCB queue 
off ACDEB. 

2. Held by TSC and by 

OPEN or CLOSE. 

Common 

DWALOCK 

8 

80 

DWA 

DWALOCK 

One 

Used by certain disabled 
TSC modules to serialize 
use of the disabled work 
area (DWA). 

MVS, 

VM, 

and VSE 
Pre-V3R2 

HNTELOCK 


40 

Host Node 
Table 

Entry 

HNTELOCK 

One per 

minor 

node 

(per 

host 

element 

address) 

Serializes updates and 
references to control 
blocks based off the 

HNTE (RDTE, NCB, 

LUCB, FMCB). 

MVS, 

VM, 

and VSE 
Pre-V3R2 

HNTLOCK 

5 

20 

Host Node 

Table 

(ISTHNT) 

ATCHNTLK 

One 

Protects updates and ref¬ 
erences to HNT during 
most CIDCTL functions. 

MVS, 

VM, 

and VSE 
Pre-V3R2 

HSQCHAIN 

1 

08 

ATCVT 

ATCHSQLK 

One 

Serializes usage of the 
HSQH queues. One lock 
is used to protect all of 
the queues. 

Common 

INNLOCK 

9 

100 

ATCVT 

ATCINNLK 

One 

Ensures that PIUs that 
are going to a node that 
is in slowdown mode are 
sent in FIFO order. 

Common 

PDBUFLK 

9 

100 

ATCVT 

ATCBUFLK 

One 

Allows the user to move 
in problem diagnosis 
trace data before the 
data is processed. 

Common 

PSTLOCK 

8 

80 

ATCVT 

ATCPSTLK 

One 

Serializes queueing and 
dequeueing of FMCB to 
PSTFMCB queue. Serial¬ 
izes release of PST 
storage. 

Common 


Figure 9 (Part 1 of 2). VTAM Locks 
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Name 

Lvl 

Hex 

Value 

Control 

Block 

Field Name 

Number 

Function 

Applies to 

QUEUE 

9 

100 

PAB 

PABLOCK 

One per 

extended 

PAB 

Serializes queueing and 
dequeueing of work ele¬ 
ments to an extended 

PAB. 

Common 

RDTLOCK 

3 

04 

ATCVT 

ATCRDTLK 

One 

Protects users of CIDCTL 
(PAFIND). Obtained by 
PUNS when a network- 
addressable unit is to be 
added or deleted, or a 
use count decremented. 

Common 

VOCLOCK 

2 

02 

ATCVT 

ATCVOCLK 

One 

1. Serializes 

OPEN/CLOSE with VARY. 

2. Serializes VARY Acti¬ 
vate, VARY Deactivate, 
and VARY ERP. 

Common 

VRLOCK 

3 

04 

VRBLK 

VRBLOK 

One per 

virtual 

route 

Serializes usage of the 
VRBLK. 

Common 


Figure 9 (Part 2 of 2). VTAM Locks 


CRA 



CRALKACT 

1 

k Level 1 Lock 
(CRAL1PTR) 

1 

k Level 2 Lock 
(CRAL2PTR) 

1 

k Level 3 Lock 
(CRAL3PTR) 

1 

Level 4 Lock 
(CRAL4PTR) 

i 

Level 5 Lock 
(CRAL5PTR) 

1 

k Level 6 Lock 
(CRAL6PTR) 

1 

k Level 7 Lock 
(CRAL7PTR) 


f Level 8 Lock 
(CRAL8PTR) 


\ Level 9 Lock 

1 (CRAL9PTR* 

L ^- 


Lock level held is relative to byte and bit position. 
Byte 3, bit 6 corresponds to lock level 2; 
byte 3, bit 5 corresponds to lock level 3; 
and so on. 

The value of this word corresponds to either 
a hexadecimal value or to a combination 
of hexadecimal values in the table above. 


Figure 10. Pointers to VTAM Locks 
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Checking Whether the VARY INACT,FORCE Command Can Complete 

If the operator attempted a vary inact,force command, you should check whether 
the command can be completed or whether there is a vtam problem. Determine 
this using the following steps according to the resource specified on the vary inact 
command. 

1. Channel-attached physical unit or logical unit, SNA or non-SNA: 

a. Display the resource status. If it is phlin, phlac, pdluc, or psubi, the 
channel is hung or a required interrupt is missing. 

b. If the status is pnfyx, go to step lion page 45. 

2. Link-attached sna logical unit, switched logical unit: 

a. Display the resource status. If it is pnfyx, go to step 11 on page 45. 

b. If it is anything else, there is a vtam problem. 

3. Link-attached bsc 3270 logical unit: 

a. Display the resource status. You should see pdacl or pfdlu. 

b. Issue vary inact,force for the ncp or ca major node that ncp or ca defines 
the device. 

c. If the deactivation succeeded and all lower-level nodes are inactive, 
message istiosi (or sbosi, for vtam V3R1 or V3R1.2 running under vse) will indi¬ 
cate this. 

d. Display the status of all the resources in the ncp or ca major node. 

e. If the status is pnfyx, go to step 11 on page 45. 

f. If it is anything else, there could be a vtam or ncp problem. Goto 
“Reporting Procedure" on page 68. 

4. Link-attached sna physical unit, switched physical unit: 

a. Display the resource status. You should see pdisc or pfdsc. 

b. Issue vary inact.force for either the physical unit to which the device is 
attached, or for the ncp or ca major node that defines the device. 

c. If the deactivation succeeded and all lower-level nodes are inactive, 
message istiosi (or sbosi, for vtam V3R1 or V3R1.2 running under vse) will indi¬ 
cate this. 

d. Display the status of all the resources attached to the ncp. 

e. If the status is psubx, go to step 10. 

f. If the status is pnfyx, go to step 11 on page 45. 

g. If it is anything else, there is a vtam problem. 

5. Link-attached bsc 3270 physical unit: 

a. Display the resource status. You should see pdacp or pfdcp. 

b. Issue vary inact.force for the ncp orcA major node that defines the device. 

c. If the deactivation succeeded and all lower-level nodes are inactive, 
message istiosi (or sbosi, for vtam V3R1 or V3R1.2 running under vse) will indi¬ 
cate this. 

d. Display the status of all the resources in the ncp or ca major node. 

e. If the status is psubx, go to step 10. 

f. If the status is pnfyx, go to step 11 on page 45. 

g. If it is anything else, there is a vtam problem. 

6. Local sna or non-SNA major node, switched major node: 

a. Display the resource status. You should see psubx. 

b. Issue vary inact.force for any minor nodes that are not inactive. This 
should allow deactivation to be completed. 
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7. Link: 

a. Display the resource status. You should see pdlnk. 

b. Issue vary inact,force for the ncp to which the link is attached. This should 
allow deactivation to be completed. 

8. Channel-attached ncp: 

a. Display the resource status. You should see pdisc. 

b. Press the reset load button on the communication controller. This should 
allow deactivation to be completed. 

9. Link-attached ncp: 

a. Display the resource status. You should see psubx. 

b. Display the status of the lower-level nodes. 

c. If the status is pnfyx, go to step 11. 

d. If the status is anything else, there is a vtam problem. 

10. psubx status: 

a. Display the status of the lower-level nodes to find any pending states. 

b. Deactivate any active or pending nodes. This should allow deactivation to 
be completed. 

11. pnfyx status: 

a. For application programs with an ns exit: 

If the vary inact,force command is unable to complete, there is a vtam 
problem. Otherwise, deactivation should complete. 

b. For application programs with only a losterm exit: 

1) If the application program has issued a clsdst macroinstruction, deac¬ 
tivation should complete. 

2) If the application program has not issued a clsdst macroinstruction for 
the logical unit, issue a second vary inact,force for the logical unit in 
question. If that does not correct the problem, you may need to cancel 
the application program to allow the deactivation to complete. (Can¬ 
celling the application program terminates all of the lu-lu sessions 
with the application program.) 

c. For application programs with neither exit: 

Deactivation will not complete until the application program issues clsdst, 
the application program closes its acb, or the operator cancels the applica¬ 
tion program. 

If you came to this procedure from step 2d on page 31, return now to step 2e on 
page 31. 
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Loop Procedure 

If the problem is a loop, use the procedure in Figure 11 on page 47 to collect the 
following documentation: 


• System console log 

• Messages associated with the loop (if any) 

• Failing module id 

• Dump output: 

- MvsQump of the vtam address space 

- VM Dump of the vtam virtual machine 

- vsEQump of the vtam partition 

• Error file output: 

— MVS vmlogrec 

- VSESYSREC 

• For a problem associated with a device: 

- vit trace output (all except lock) 

- i/o trace output (of ncp) 

- Session trace data (if using NetView or nldm) 

- Session awareness data (if using NetView or nldm) 
— NetView or npda report (if using NetView or npda) 

- mvsqtf ccwtrace output (if available) 

- vm V m branch trace 

- vmvscs internal trace 

- vm cp internal trace 

- VM CP virtual machine trace 

- vm gcs internal trace 

- vsesdaid ccwd trace output 
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Figure 11 (Part 1 of 2). Overview of the Loop Procedure 
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Figure 11 (Part 2 of 2). Overview of the Loop Procedure 

Detailed descriptions of the steps involved in the loop procedure begin on page 49. 
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1. Trace the loop. 

Loop problems may involve many modules or a single module. If possible, 
trace the looping instructions. Using the Operator's Reference for your host 
processor, instruction-step through the looping addresses. Save these 
addresses for use in diagnosing the problem. 

In an enabled loop (psw is enabled for interruptions), psws with low addresses 
may indicate a normal system process. Since most vtam routines are enabled, 
look for psw addresses that are in the range of the vtam address space (mvs), 
virtual machine (vm), or partition (vse). 

mvs You should also look for addresses within vtam modules that are in the 
system range (lpa). 

If the vtam internal trace was running when the loop started, look for any 
exception conditions that might have led to the loop. If the internal trace was 
not running, you will have to re-create the problem to get the trace at the time 
of the loop. Set the internal trace to mode = ext to record the trace entries in an 
external file. 

vm Issue display psw, then issue display regs several times to trace the loop. 
Then, obtain a vm branch trace of the loop, and start the vscs internal trace, if 
you have vscs. (The vscs trace facility is explained in Chapter 6, “vm Using 
VSCS Service Aids.”) 

2. vm Look for a vscs loop. 

If you are using vscs, and the loop occurs during vscs initialization or termi¬ 
nation, go to Chapter 5, “vm Procedures for VSCS Problems” on page 93. 

If you are using vscs, and the loop occurs at a time other than vscs initializa¬ 
tion or termination, go to “vm Presentation Services is in a Large Enabled 
Loop" on page 121. If you cannot identify the problem using those procedures, 
return to this procedure. 

mvs If you are using tso/vtam, use this procedure. You do not need to go to 
Chapter 4, “mvs Procedures for TSO/VTAM Problems" on page 71. 

3. Get dump output. 

Get a dump of vtam: 

• mvs Issue the dump command, or press the Program Restart key. 

• vm Issue #cp vmdump, with the appropriate options. 

• vse Issue the dump command. 

If the loop is disabled, the system console will not be available for input, so 
take a stand-alone dump. (See “ mvs Stand-Alone Dump” on page 284.) Print 
the dump output. 

4. Get the system console log and logrec or sysrec output. 

The system console log may contain information, such as error messages, that 
can help you diagnose the problem. Also, print the logrec or sysrec file. 

mvs Use the logdata option to print the in-core logrec buffers. See MVS 
Service Aids for more information. 


LY30-5601-1 <Q Copyright IBM Corp. 1984, 1989 


Chapter 3. Procedures for Specific Problem Types 49 



Loop Procedure 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


5. Is a message involved? 

Determine whether there are any messages associated with the loop, such as 
a particular message always preceding the problem, or the same message 
being issued repeatedly. If so, add the message numbers to your problem doc¬ 
umentation and go to the message procedure, step 4 on page 56. 

6. Is it a device error? 

For any kind of device error, you should first check the NetView or npda report 
(if you have NetView or npda) and then the logrec or sysrec output. 

Does the logrec or sysrec output show repetitive entries for the same kind of 
error on a particular device? If so, vtam is receiving several different errors 
from that device. 

a. If the logrec or sysrec error records are for a link or link station attached 
to a communication controller, get vitpiu records and an i/o trace of the 
ncp. If you have NetView or nldm, get session trace data or session aware¬ 
ness data for the ncp. If the error records are for a link or device attached 
to a communication adapter, get vit piu records or a dynamic trace of the 
communication adapter. 

If the trace shows continual arrival of recms pius, then the repetitive entries 
in logrec or sysrec are caused by a device error. 

b. For channel-attached devices, use one or more of the following traces for 
the device to determine whether vtam is receiving many errors: 

• vtam internal trace with cio option 

• Session trace data (if using NetView or nldm) 

• Session awareness data (if using NetView or nldm). 

• mvs ccwtrace (if available) 

• vm sio and i/o traces for cp and gcs 

• v se i/o interruption and ccwd sdaid traces 

If vtam is receiving many errors, the problem is probably in the device. Try 
to trace the execution of vtam erp routines. Then continue with step 7. 

7. Is the loop traced? 

If you were able to instruction-step through the loop, go to step 15 on page 52; 
otherwise, continue with step 8 on page 51. 
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8. Find the failing module. 

Use the psw to find the failing module. 

The psw also is found in: 

• mvs The logrec output, the sdwa, or the RTM2WA 

When you use psw restart to terminate a looping task, a logrec entry is 
created with a completion code of X'071 1 for the task. An RTM2WA is also 
created for the task. Use the logrec record and the rtm work area to 
locate the failing module. See the diagnostic books for your operating 
system for help in locating the psw in dump output. 

Depending on the psw bit 32, the last 3 bytes (24-bit mode) or 4 bytes (31-bit 
mode) of the psw contain the address being executed at the time of the 
dump. Scan the dump output to find the address given in the psw. 

For more information on psws, see the Principles of Operation book for 
your processor. 

Note: Addresses may not always be in numeric order because the dump 
does not always generate output in sequential order. 

If you cannot find the address, the dump may not contain the relevant 
portion of main storage. For example, the address may be in lpa storage. 
Have this portion of storage dumped, or use output from lpamap to identify 
the module, and proceed as above. 

• vm You should have found the psw when you issued display psw in step 1 on 
page 49. 

• vse The location of the psw in the dump will vary, depending on what type 
of dump was taken. See VSE Service Aids for help in finding the psw in the 
dump output. 

The last 3 bytes of the psw contain the address being executed at the time 
of the dump. Scan the dump output to find the address given in the psw. 

For more information on psws, see the Principles of Operation book for 
your processor. 

Note: Addresses may not always be in numeric order because the dump 
does not always generate output in sequential order. 

9. Find the module name containing the failing address. 

vtam identifies modules with an ebcdic module name and Julian date at or near 
the beginning of most modules. This module identifier will usually be in the 
form: 

istxxxxx yy.ddd [nnnnnnn] 

where xxxxx is the last five characters of the module name, yy.ddd is the Julian 
date the module was assembled, and nnnnnnn is the latest ptf (if any) that has 
been applied to this module. 

To find the module id, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The 
module id is printed in ebcdic. Add the module name to your documentation 
list. 
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10. Find the module pointed to by register 12. 

General register 12 (X'OC 1 ) is normally the base register for vtam routines. In 
a vtam loop, register 12 should point to the same module found in step 11. If 
not, add this module name to your documentation list. 

11. Find the module pointed to by register 14. 

General register 14 (X'OE 1 ) may point to a module that called the routine that 
is looping. Add this module name to the documentation list. 

Normally, you should add the module names from steps 9,10, and 11 to your 
documentation list. You can report the problem next, but you may need to con¬ 
tinue with step 12. 

12. Get the system trace output. 

The system trace may show many external and i/o interrupts. The psw 
addresses in system trace entries will be part of the loop. 

13. Get the vit output. 

The vit is useful in determining the reason for the loop, such as a process 
being continually re-dispatched for the same request. Get any vit output avail¬ 
able. If the vit is not available, and vtam will accept the command, start the vit 
and specify mode=ext. If vtam will not accept the command, it may be neces¬ 
sary to re-create the problem. For more information on the vit, see 
Chapter 8, “Using the VTAM Internal Trace.” 

14. Examine the trace entries. 

By examining the trace entries, you should be able to determine whether there 
is a loop. The most obvious loops would be a module or modules getting con¬ 
tinual control of the vtam system, or a control block chaining to itself. Check 
the output of the pss option to see which vtam routines are getting control. 

If you see a pattern of repetition in the trace entries, it does not necessarily 
mean vtam is looping. Some vtam processes are timer-driven and repeat peri¬ 
odically. Also, the absence of any apparent loop does not necessarily mean 
vtam is not looping. The loop may not contain a vtam trace point. 

If a module or modules are looping, get their addresses from the trace entries. 
Step 15 explains how to find the module name. 

If you find a control block chained to itself, or if a queue of control blocks is in a 
cycle, try to identify the control block. Most control blocks have a 1-byte id at 
offset X' 00'. See the control block id codes in Appendix E, “Storage and 
Control Block ID Codes” on page 657 to identify the control block name. 

15. Find the module names. 

Use the addresses found in step 14 to find the module names involved in the 
loop. 

To find the module id, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The 
module id is printed in ebcdic. Add this module id to the documentation list. 
Continue with step 16. 

16. Report or go to the failing module procedure. 

If you determined the module names, go to “Failing Module Procedure” on 
page 67. Otherwise, you are ready to contact ibm. Go to “Reporting 
Procedure” on page 68. 
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Message Procedure 

If the problem is a message, use the procedure in Figure 12 on page 54 to collect 
the following documentation: 


• Issuing module 

• Message number 

• System console log 

• Dump output if required 

• vit output. 


Note: If your installation changed the text of the message, the message id may not 
be included, or may not match the id of the message as it appears in VTAM Mes¬ 
sages and Codes. Therefore, it is recommended that you re-create the problem 
using the VTAM-supplied message text. Otherwise, determine what VTAM-supplied 
message text corresponds to the message text your installation is using. 
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Figure 12. Overview of the Message Procedure 

Detailed descriptions of the steps involved in the message procedure begin on 
page 55. 
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1. Report if the problem is in the message itself. 

If the content of the message is incorrect or the meaning of the message is not 
clear, go to "Reporting Procedure” on page 68. 

2. Follow the recommended action. 

For all messages, see VTAM Messages and Codes for recommended operator 
and programmer actions. (See the list of vtam books in the "Bibliography” on 
page 671 for the appropriate form number.) In addition: 

• If the message indicates a storage problem, go to step 3. 

• If the message indicates a tso/vtam problem, see Chapter 4, " M vs Proce¬ 
dures forTSO/VTAM Problems.” 

• If message DTIS99I indicates a vscs problem, see “vm Message DTIS99I Indi¬ 
cates a VSCS Internal Error” on page 135. 

The following list shows message prefixes and the components that issue 
those messages. 

Prefix Issuing Component 

DTI VSCS 

IKT TSO/VTAM 

1ST VTAM (MVS, VM, and V3R2 VSE) 

5 VTAM (VSE V3R1 and V3R1.2) 

If the message starts with any other characters, it comes from another network 
component. 

3. Get documentation for storage problems. 

The following vtam messages may indicate a storage problem: 


MVS VM 
and V3R2 

VSE 

V3R1 and 

V3R1.2 

VSE 

Description 

IST561I 

5F61I 

Indicates a buffer pool shortage 

IST562I 

5F62I 

Indicates that CSA has been reached 

IST563I 

5F63I 

Indicates that MAXPVT has been reached 

IST564I 

5F64I 

Contains the subpool number 

IST565I 

5F65I 

Contains the subpool number 

IST566I 

5F66I 

Contains the subpool number 


Figure 13. VTAM Messages Issued for a Storage Shortage 

vse Message IST561I (or 5F6ii, for vtam V3R1 or V3R1.2) may be issued when there 
is no problem. For example, a request may come in for a buffer pool before 
the pool expansion request can run. You must display buffer use to determine 
this. 
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If the message is issued frequently or continuously, get a dump: 

mvs Dump vtam common and private storage areas. 2 

vm Dump the vtam virtual machine. 

vse Dump the vtam partition. 

For messages that give a subpool number, dump the storage containing that 
subpool. 

It Is highly recommended that you use a dump formatter. Dump formatters are 
described in “mvs vm Formatting and Printing Dump Output” on page 279. 

After getting the documentation for your storage problem, go to "Reporting 
Procedure” on page 68. 

4. Identify the issuing module. 

Try to identify the module issuing the message. If the msgmod start parameter 
was active or the modify msgmod command was issued before the problem 
occurred, the message text contains the last five characters of the issuing 
module name. Add the message prefix to the module name, and add this 
name to your problem documentation. (To modify the module identifier in mes¬ 
sages, see "Modify Message Module Identification” on page 270.) 

The vtam internal trace msg entries contain the message number, the save 
area address, and the module id (the 4th, 5th, 7th, and 8th characters of the 
module name). Use these to identify the issuing module. If the trace entry 
contains no module identifier, use the caller's address from the trace entry, or 
find the message issuer by using the message-to-module cross reference in 
VTAM Messages and Codes . 

5. Report or go to the failing module procedure. 

If you know the name of the issuing module, go to "Failing Module Procedure” 
on page 67. If you are unable to determine the issuing module or resolve the 
problem, go to “Reporting Procedure” on page 68. 


Although vtam detects storage shortages in the common storage area, vtam may not be 
causing the shortage since this area is shared by all address spaces. 
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Incorrect Output Procedure 

If the problem is incorrect output, use the procedure in Figure 14 on page 58 to 
collect the following documentation: 


• Specific output that is incorrect 

• Device type (if appropriate) 

• Buffer contents trace output 

• vit trace output (all except lock) 

• Session trace data (if using NetView or nldm) 

• Session awareness data (if using NetView or nldm) 

• Network controller line trace output (3710 only) 

• MVS 

- gtf ccwtrace output (if available) 

- For tso problem — tget/tput trace 

• VM 

- cp internal trace 

- cp virtual machine trace 

- GCS internal trace 

- For vscs problem — vscs internal trace 

• VSE 

- sdaid ccwd trace output 

- Communication adapter line trace output 

• Network problem: 

- Line trace 

- Generalized piu trace (gpt) 

- Transmission group (tg) trace 

- Scanner interface trace (sit) for 3720, 3725, and 3745 only. 
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Figure 14. Overview of the Incorrect Output Procedure 

Detailed descriptions of the steps involved in the incorrect output procedure begin 
on page 59. 
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1. Describe the incorrect data. 

Most incorrect output problems pertain to data contained in a piu. This can be 
incorrectly formatted user data, invalid routing information, or other types of 
missing or incorrect data. These types of problems are generally difficult to 
diagnose, as they show up only at the end-user locations. From the following 
list, choose all the symptoms that apply to your problem and add them to your 
problem documentation: 

• Cursor is in the wrong place or missing. 

• Format of data is incorrect. 

• Data is truncated. 

• Data is incorrect. 

• Data is missing. 

• Problem is related to an application program macroinstruction. 

• Screen is improperly formatted. 

• Session is hung. 

• Terminal is hung. 

Note: The term “hung terminal” means the user is prevented by the system 
from entering data. 

2. Determine the device type. 

If the problem is associated with a specific device type, add the device type (for 
example, 3270 terminal) to your problem documentation. 

3. mvs is it a tso/vtam user problem? 

If the incorrect output problem involves tso/vtam, go to “Mvs Screen Manage¬ 
ment Problems” on page 81. 

4. vm is It a vscs user problem? 

If the problem involves a vscs user, follow the procedure in “vm Incorrect 
Output Problems” on page 138. 

5. Get network trace and dump output. 

Re-create the problem with the following service aids active: 

Note: For more information on vtam service aids, see Chapter 7, “Using 
VTAM Service Aids.” Operating system service aids are documented in oper¬ 
ating system books. 

• Start the vtam buffer contents trace for the failing application program and 
terminal logical units. 

• mvs |f you have an ibm 3710 Network Controller, start the network controller 
line trace. It traces information passing to and from a 3710. 

• Start the vtam internal trace with mode = ext. (You do not need to use the 
lock option unless you suspect that a lock is not working.) This shows the 
type of requests being processed between the application program and the 
end user or terminal, and the control information for routing, pacing, and 
so on, in each piu sent in the network. 

• You should start the generalized piu trace if the problem involves lines or 
devices attached to a communication controller. This will show how far the 
piu got within the ncp and what the piu looked like (its control information) 
when it was sent to the line. 
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• vse If the problem involves lines or devices attached through a communi¬ 
cation adapter, start the dynamic trace of the communication adapter. This 
will show any problem related to the line. 

• If you have NetView or nldm, you can use the session trace data to deter¬ 
mine the requests and responses received and sent by vtam and the other 
network nodes. 

• mvs vse If it is available, you can now use the gtf ccwtrace (in mvs) or the 
sdaid ccwd trace (in vse). These trace the cows, i/o interruptions, and all 
ccw data for each Start i/o issued by the system. For a problem where 
data in the ru is invalid, this is the only service aid that will show the entire 
piu. For more information on these traces, see the diagnostic books for 
your operating system. 

• As soon after the problem occurs as possible, take a dump of the applica¬ 
tion program, vtam, and (in mvs) tso/tcas. Stop all traces, and print the 
dump and trace output. 

The dump is used to reference storage addresses, such as control blocks and 
module entry points. The trace data shows at what point the data was modi¬ 
fied, and what pabs the data was on as it was processed by vtam. Take the 
dump during the re-create, when the traces are running. A dump taken earlier 
may not be accurate because the terminal device may have been deactivated 
and reactivated. This would allocate a different set of control blocks. 

6. Examine the trace output. 

Examine the individual trace entries to find the failure. If the problem concerns 
user data format, and the buffer contents trace or piu trace does not show the 
invalid data, use the output from the vit trace with the sscp option. 

mvs The ccwtrace (if available) can be used to see whether data is correct 
when it goes to the ncp or logical unit. The vtam internal trace records CC2, ci2, 
and C02 contain the first 24 bytes of this data. 

When output data is correct: 

If the traces show that the data or the control information in the rh/th as it 
leaves vtam is correct, the problem is not in vtam or the application program; 
go to step 9 on page 61. If the data going to the network is invalid, continue 
with step 7. 

When input data is incorrect: 

If the traces show that invalid data is entering vtam from an external network 
source, the problem is in the network; go to step 9 on page 61. If the data from 
the network is valid, the problem is in vtam or an application program; con¬ 
tinue with step 7. 

7. Is it vtam or an application program? 

The problem has been narrowed down to vtam or the application program. 
Examine each trace entry to determine whether the information from the appli¬ 
cation program was incorrect. If vtam seems to be responsible, go to 
"Reporting Procedure" on page 68; otherwise, continue with step 8 on 
page 61. 
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8. Is more application program help needed? 

For ibm application programs such as cics or ims, you may find additional diag¬ 
nostic help in the ibm application program books. If you decide that the 
problem is with an ibm application program, contact the appropriate ibm repre¬ 
sentative for that product. 

9. Is the problem with an external network device? 

The problem has been narrowed down to the vtam network, but not to vtam 
itself. Try to identify the device or program responsible. You can use service 
aids, such as the ncp line trace, generalized piu trace, or transmission group 
trace, to trace data flow between the ncp and terminal logical units. For infor¬ 
mation on how to use these traces, see "Traces Provided by NCP" on 
page 245. For a 3720, 3725, or 3745, use the scanner interface trace (sit) to 
distinguish between ncp problems and line or terminal problems. If you 
suspect the ncp, see the NCP, SSP, and EP Diagnosis Guide . 

Chapter 7, “Using VTAM Service Aids” explains how to use other service 
aids, including the ncp dump. Contact the appropriate ibm representative for 
the device or program identified as the cause of the problem. 

vsEThe communication adapter line trace can be used to discriminate between 
a vtam error and one that is related to a device or line attached through the 
communication adapter. For more information, see the diagnostic book for the 
host processor. 

10. Report the problem. 

Go to "Reporting Procedure” on page 68. 
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Performance Procedure 

If the problem is performance, use the procedure in Figure 15 on page 63 to 
collect the following documentation: 


• System console log 

• Error file output: 

— MVS VM LOGREC 
- VSE SYSREC 

• Tuning statistics 

• sms (buffer use) trace output 

• Network controller line trace output (3710 only). 
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Figure 15. Overview of the Performance Procedure 

Detailed descriptions of the steps involved in the performance procedure begin on 
page 64. 
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Get logrec or sysrec output. 

Performance problems are often caused by hardware errors. These hardware 
errors cause software error recovery processing to occur, which degrades 
system performance. For this reason, you should get logrec or sysrec output. 
logrec or sysrec may show a large number of hardware errors for a particular 
device or group of devices. If the errors are limited to a single device, a hard¬ 
ware error is probably the cause. If the errors appear on many or all terminals 
of one type, software is more likely to be the problem, although hardware may 
still be at fault. If you suspect a particular device type, add it to your documen¬ 
tation list. 

Examine the system console log. 

The system console log may contain messages to help diagnose a problem. 
Add the message id to the documentation list: 

mvs Document the message id in the form istxxxx or iktxxxx. 

vm Document the message id in the form istxxxx or dtixxxx. 

vse Document the message id in the form sxxxx (for vtam V3Ri and V3R1.2) 

or istxxxx (for vtam V3R2). 

The system console log may also contain information about command prob¬ 
lems. For example, operator commands might be taking too long to complete. 
Add the command name (for example, vary act) to the documentation list. 

mvs For tso/vtam, see Chapter 4, “mvs Procedures for TSO/VTAM Problems” 
on page 71. 

If you are using tso/vtam, go to “mvs Performance Problems” on page 89. If 
you cannot resolve the problem with the procedure in Chapter 4, “mvs Proce¬ 
dures for TSO/VTAM Problems,” return to this procedure. 

vm For vscs, see Chapter 5, “vm Procedures for VSCS Problems” on page 93. 

If you are using vscs, and you have not identified the cause of the problem, go 
to “vm Performance Problems” on page 143. 

Get tuning statistics. 

If the performance problem is associated with traffic through a channel- 
attached host, a channel-attached communication controller, or a channel- 
attached sna physical unit, it may be helpful to get tuning statistics for vtam. 
(For more information on tuning statistics, see “Modify Tuning Statistics” on 
page 272.) 

Get output from the sms (buffer use) trace. 

You may have enough information to identify the problem. If so, go to 
“Reporting Procedure” on page 68. If you do not, continue with this step. 

a. Buffer pool expansion can cause performance problems. During vtam 
initialization, error recovery, and vary and display command processing, 
buffer usage is higher than normal. If buffer expansion is used, buffer 
pools should not expand except during such peak periods. Thus, what 
appears to be high buffer usage could be normal depending on the level of 
system activity. 

Run the buffer use trace (type-sms). For information on how to start the 
trace and examine the output, see “SMS (Buffer Use) Trace” on page 237. 
For diagnostic purposes, change the buffer request interval (racbsnap) in 
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module istracon to a value of 50 (X 1 32 1 ). This change causes trace entries 
to be written more often to give a more accurate picture of buffer usage. 

b. Using the time stamps in the system console and buffer use trace, corre¬ 
late an excessive number of buffer pool expansions or large number of 
buffers used from a single pool with network activity recorded on the 
console. Constant high usage of a buffer pool may show that not enough 
buffers were allocated at vtam initialization to properly support the level of 
network activity. Also look for a buffer pool that continually grows; buffers 
may not be released by some vtam routine. Add the name of a particularly 
active buffer pool (for example, lpbuf or iobuf) to your documentation list. 

7. mvs Get output from the network controller line trace. 

If an ibm 3710 Network Controller is installed, start the network controller line 
trace. This traces information passing over the lines to and from a 3710. (For 
more information about this trace, see “mvs Network Controller Line Trace 
(3710 Only)” on page 250.) Print the trace output with tap. 

8. Get additional documentation. 

If no solid indication of a problem is apparent at this point, run the vtam 
internal trace (vit) with opt=pss.api,sscp,piu* and mode = ext. This creates a 
history of vtam activity. At the time of performance degradation, stop vit and 
take an svc dump of vtam. (For more information on the svc dump, see "mvs 
SVC Dump” on page 284.) Print the dump and trace output for future refer¬ 
ence. 

9. Report the problem. 

Go to “Reporting Procedure” on page 68. 


If you are running an i.u 6.2 application, include the appc vit option in this list. 
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Documentation Procedure 

Note: Before using this procedure, be sure that documentation is the problem. A 
vtam problem may cause the documentation to appear wrong. 

If the problem is documentation, use the procedure in Figure 16 to collect the fol¬ 
lowing documentation: 


• Incorrect information 

• Form number of book. 



Figure 16. Overview of the Documentation Procedure 

Detailed descriptions of the steps involved in the documentation procedure begin 
below. 

1. Identify the incorrect information. 

Add to the documentation list the name of the macro, operand, or procedure 
that is incorrectly defined or explained in the documentation (for example, 
“line trace.”) 

2. Record the form number. 

Add the form number of the vtam book to your documentation list in the form 
ccnnnnnnrr (omitting the dashes in the number; rr is the revision level). For 
example, report the form number of this book as LY30560100. 

3. Report the problem. 

Go to “Reporting Procedure” on page 68. 

Note: Report a documentation problem only when it causes a vtam problem. 
For suggestions, comments, or questions about vtam books, use the Reader's 
Comment Form at the back of the book. 
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Failing Module Procedure 


Failing Module Procedure 

Use this procedure if you have identified a failing vtam module in one of the other 
procedures (abnormal end, message, or loop). Figure 17 shows an overview of 
the failing module procedure. 

Use this procedure to get the following documentation: 


• Module id and ptf eyecatcher 

• Module descriptive name 

• Caller of module 

• vit trace output. 



Figure 17. Overview of the Failing Module Procedure 

Detailed descriptions of the steps involved in the failing module procedure begin 
on page 68. 
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1. Determine the caller of the service routine. 

The failure may have occurred in a vtam service routine used for many pur¬ 
poses. Determine the caller of the service routine. Use the save area con¬ 
ventions in “Using a Dump to Follow the Execution Sequence of VTAM 
Components” on page 302. 

2. Examine the work element structure. 

If your problem type is an abnormal end or loop, and the module is dispatched 
under control of vtam pss, find the cra/rph associated with the process. (See 
step 10 on page 40 in the wait procedure.) The rphwea field (at offset X' 1C) 
usually points to the work element associated with the process at the time it 
was dispatched. To identify the work element, see “Using a Dump to Follow 
the Execution Sequence of VTAM Components” on page 302. 

From the work element, it may be possible to identify an sna request/response 
type, an operator command, or an application program request that ultimately 
caused the process to receive control. Add this request or command name to 
your documentation list. 

If the rphwea field does not point to the work element, continue with step 3. 

3. Get more trace output. 

Use the vrr options pss and sms to get more information about how the failing 
module received control or where the relevant control blocks are found. 

Use the last disp entry for the failing process to get the address of the work 
element and module name of the process entry point. 

Continue with “Reporting Procedure." 


Reporting Procedure 

Depending on the terms and conditions of your service agreement, you should 
report the problem to either the local branch office or the ibm Support Center. 

After asking for your account name and other customer identification, the service 
representative will ask for a brief description of the problem. Your documentation 
list should contain the answers to all questions related to the problem. 

You can find more information about the ibm Support Center and our problem 
solving process in the Programming System General Information Manual. 
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Chapter 4. MVS Procedures for TSO/VTAM Problems 

This chapter shows you what documentation to collect for each type of common 
tso/vtam problem. Use this chapter in conjunction with Chapter 3, “Procedures 
for Specific Problem Types” on page 19. 

Note: Most traces discussed in this chapter are described in Chapter 7, “Using 
VTAM Service Aids.” The exception is SVC93 and SVC94 entries, which are 
described in the Debugging Handbook , Volume 1. For vtam and tso/vtam command 
syntax, see VTAM Operation. 

To use this chapter, start below and follow the steps. 

1. Are you receiving one or more of the following messages? 

• uss message 7 'LU-name unable to establish session - RU-name failed with 
sense sense’, or similar uss message 

• uss message 10 (the “good morning" message) 

• Message IKT024I or iktoi9i at the operator's console 

• Message IKJ608I at the operator's console. 

If so, go to “ mvs Logon Problems” on page 73. 

Otherwise, continue with step 2. 

2. Have you encountered one of the following abends? 

• ABENDOAB 

• ABENDOAC 

• ABENDOAD 

• ABEND15D. 

If so, go to "mvs TSO/VTAM Abends” on page 77. 

Otherwise, continue with step 3. 

3. Do you have a hung terminal? 

• The terminal does not respond to any keys you press. 

• You must enter data from the terminal before processing will continue (in a 
situation where output is expected). 

If so, go to “ mvs Hung Terminal Problems" on page 79. 

Otherwise, continue with step 4. 

4. Are you having one or more of the following screen management problems? 

• Data is in the wrong place on the screen. 

• Data stream errors occur (such as operation checks, commands are 
rejected, progxxx). 

• Function errors occur (such as incorrect full-screen processing or incorrect 
line prompting in input mode of tso edit). 

• Data length is incorrect. 

• Data content is incorrect. 
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If so, go to ‘mvs Screen Management Problems" on page 81. 

Otherwise, continue with step 5. 

5. Are you having one or more of the following screen size problems? 

• The terminal does not operate in the expected screen size after you log on. 

• The screen is not always the expected size during a tso session. 

If so, go to “mvs Screen Size Problems" on page 86. 

Otherwise, continue with step 6. 

6. Are you having one or more of the following performance problems? 

• Slow response time 

• An increase in the number of detected waits 

• An increase in the number of swap-outs. 

If so, go to “mvs Performance Problems" on page 89. 

Otherwise, if your problem is not listed in the steps above, it is probably not a 
tso/vtam problem. Go back to Chapter 3, “Procedures for Specific Problem 
Types" on page 19 and look for a more likely problem symptom. If you cannot 
find a more likely symptom, go to “Reporting Procedure” on page 68. 
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MVS 


Logon Problems 

This section provides documentation requirements and diagnosis procedures for 
logon problems. 

The recommended documentation is: 


• vtam buffer contents trace. 

To see the data in the buffer contents trace, set conftxt = no in the tsokeyoo 
member of sysi.parmlib before starting tso/vtam. 

• vtam internal trace with mode = ext and option = (api.piu,sscp.msg). 

The vtam internal trace may not be required. Review the diagnosis procedure 
for your problem to see if it is required. 


1. Did your first logon using uss commands fail? 

If so, continue with the next step. 

Otherwise, go to step 5 on page 74. 

2. In VTAM Customization , review the process for setting up the uss table and 
using uss commands. Check for the following errors: 

• Is your logon command syntax incorrect? 

If so, try to log on using the correct command syntax. 

Otherwise, continue with the next step. 

• Is the logmode name incorrect? 

If the logmode name is specified incorrectly, or if a default logmode entry 
that is inappropriate for the device type is used, you will get USSMSG7. Look 
up the sense code in VTAM Messages and Codes and correct the logmode 
name. 

3. Can you log on to tso without using uss commands? 

If you cannot log on at all, go to step 4. 

If you can log on, start the vtam buffer contents trace and log on again. Look at 
the trace output to see what session parameters are contained in the bind, and 
compare those parameters to the ones in your logmode table. 

If the session parameters in your logmode table are incorrect, make the neces¬ 
sary corrections. Also, make sure the dlogmod operand specifies the correct 
logmode table entry. (For more information on defining tso/vtam session 
parameters, see VTAM Installation and Resource Definition.) 

If you still cannot identify the problem, go to “Reporting Procedure” on 
page 68. 

4. If you cannot log on at all, and if this is your first logon attempt from the device 
as well as your first logon attempt using uss commands, go to step 5 on 

page 74. 

If you cannot log on at all, and if this is not your first logon attempt from the 
device, go to “Reporting Procedure” on page 68. 
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5. Did your first logon from a particular device fail? 

If so, continue with the next step. 

Otherwise, go to step 7. 

6. Check for an error in the terminal definition statement, the logmode table, or 
the modeent macro. (These are described in VTAM Installation and Resource 
Definition.) 

a. If you receive message IKT024I with return code X'210000' or X'220000', 
the bind has been rejected. The following steps should help you find the 
invalid portion of the bind: 

1) Locate the binfm in the bind, binfm must be X'02‘ or X'03'. (For more 
information on coding the bind, see VTAM Programming.) 

2) If a pservic is coded, see VTAM Installation and Resource Definition to 
make sure all fields are coded correctly. 

b. Check to see if the dlogmod name is correct on the terminal definition 
statement. 

If it does not match an entry in the logmode table, the first entry in the 
logmode table is used as the default. The parameters on the default 
logmode table entry may not be appropriate for your device type, and as a 
result, the wrong bind image may be passed to the logon exit and a clsdst 
pass failure may occur. 

Note: You can see this failure in the vtam internal trace using the api 
option. For more information on the vtam internal trace, see 
Chapter 8, “Using the VTAM Internal Trace.” 

c. Check the logmode table entry to see if the parameters are specified cor¬ 
rectly for your device type. 

If not, the wrong bind image may be passed to the logon exit and a clsdst 
pass failure may occur. 

d. Check to see if the modeent macro is defined correctly. 

If it is not, the terminal may reject the bind, or the terminal may indicate to 
the logon exit that the terminal is not supported by tso/vtam. 

e. If you have not identified the problem, and if users can log on toTSO from 
other terminals, start the vtam buffer contents trace and check the bind. 

f. If logons fail for all terminals, or if the bind in the buffer contents trace is 
what you expected, run the vtam internal trace with options api, piu, sscp, 
and msg. 

g. If you still have not resolved the problem, go to “Reporting Procedure” on 
page 68. 

7. Did previous logons succeed, but now you cannot log on? 

If so, continue with the next step. 

8. Did you get message IKJ608I? 

If not, go to step 13 on page 75. 

If so, continue with the next step. 
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9. Is message IKJ608I followed by message iktkmi? 

If it was not, go to step 10. 

If if was, a storage shortage prevented the open acb from completing success¬ 
fully. This is a vtam storage shortage, not a tso/vtam storage shortage. See 
“Message Procedure” on page 53 for diagnosis information. 

10. Is message 1KJ6O8I followed by messages istso4I, ist40oi, and istsosi? 

If so, the clsdst pass may have failed. Continue with the next step. 

11. Is this a cross-domain logon? 

If not, go to step 12. 

If this is a cross-domain logon, make sure each domain has the same number 
of tso/vtam applids defined. 

If one domain has more applids defined than the other, the clsdst pass can fail, 
with an rplrtncd and rplfdb2 combination of X'1453'. (The values of these rpl 
fields are shown in the vtam internal trace using the api option. For more infor¬ 
mation on the vtam internal trace, see Chapter 8, "Using the VTAM Internal 
Trace.”) 

12. Is there an Invalid tso/vtam applid? (For more information on defining applids, 
see VTAM Installation and Resource Definition.) 

If so, correct the applid. 

If not, continue with step 13. 

13. Did you get message iktiiii? 

If not, go to step 14 on page 76. 

If so, check the message text to determine the reason for the logon failure. 

See VTAM Messages and Codes for additional diagnostic information. 
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14. Is an abendoab with return code X'0201' or X'0202' associated with the logon 
attempt? 

If not, go to step 15. 

If so, check the logrec entry for additional information. 


Reason 

Code 

Register 

Contents 

X'0105 1 

6 

RPLRTNCD, RPLFDB2, and RPLDAF 

7 

RPLFDBK2 (the word of sense) 

X'0201 1 

8 

ACBERFLG (for OPEN ACB failure) 

9, 10 

TVWA ACB Name (TSOnnnn) 

X'0202' 

8 

ACBERFLG (for OPEN ACB failure) 

1 9, 10 

TVWA ACB Name (TSOnnnn) 

X'0203' 

5 

ACBERFLG (for CLOSE ACB failure) 

6, 7 

TVWA ACB Name (TSOnnnn) 


Figure 18. MVS ABENDOAB Information in LOGREC 

Then go to “Reporting Procedure” on page 68. 

15. If none of the previous situations apply, start the vtam buffer contents trace and 
the vtam internal trace, and trace the logon attempt. Then go to “Reporting 
Procedure” on page 68. 
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mvs TSO/VTAM Abends 


tso/vtam issues several unique abends. This section briefly describes the causes 
and documentation requirements for each one. Use the information provided here 
and in VTAM Messages and Codes to try to resolve the problem. 

If you are not able to do so, go to “Reporting Procedure” on page 68. 


mvs ABENDOAB 


abendoab occurs when a vtioc module issues a vtam macroinstruction that fails. 
Depending on the values of the rplrtncd and rplfdb2 fields, the macro may be 
retried. If the retry fails, abendoab is issued. 


Offset 

Length 

(bytes) 

Description 

X'280 1 

8 

Terminal name 

X'289' 

1 

RPL request type: X 1 22 * = SEND 

X 1 23' = RECEIVE 

X 1 28A 1 

1 

RPLRTNCD 

X'28B 1 

1 

RPLFDB2 

X'28C' 

4 

RPLFDBK2 (Sense code) 


Figure 19. mvs ABENDOAB Information in a Dump of SDWA 


If this happens during the execution of a send or receive, the session is placed in 
reconnect status. 

The recommended documentation is: 


• Contents of register 15. 

This contains the reason code, which is explained in VTAM Messages and 
Codes . 

• Message text for message iktiosi. 

• The software logrec entry. 

If you have a logrec entry, look at an unformatted dump of the sdwa. 

Figure 19 describes the pertinent data you should look for in the dump. 

• The dump that is created automatically for this abend. 

For abends associated with i/o errors, a dump is not generated automatically 
unless the rcfbdump parameter of the tsokeyoo member of sysi.parmlib is set 
for it. 

• For errors that occur during session initialization or termination, run the vtam 
internal trace with options api, piu, msg, sscp, and pss. 
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ABENDOAC 

abendoac occurs when an error halts tcas processing. 
The recommended documentation is: 


• Contents of register 15. 

This contains the reason code, which is explained in VTAM Messages and 
Codes . 

• TWARSON (iKTCASWA + X ' 02 *). 

This also contains a reason code, which is explained in MVS System Codes or 
VTAM Messages and Codes. 


ABENDOAD 

abendoad occurs when the tso/vtam queue manager has a problem manipulating 
storage for the input and output queues. 

The recommended documentation is: 


• Contents of register 15. 

This contains the reason code, which is explained in VTAM Messages and 
Codes. 

• The dump that is created automatically for this abend. 


ABEND15D 

ABEND15D occurs when the issuer of a tget, tput, or tpg macro passes an invalid 
data area to the svc 93 modules. A tput or tpg request requires read access to the 
area, and a tget requires write access. abendoc4 occurs when iktvtput or iktvtget 
tries to validate the data areas passed from the application program, and IKT93EST 
changes the abendoc4 to an abendisd. 

The recommended documentation is: 


• slip dump of the abendoc4. 

The slip dump is described in the MVS Operator's Library. 

• gtf trace of svc 93 entries. 

Note: Either of these will show the invalid address. 
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MVS Hung Terminal Problems 

This section provides documentation requirements and diagnosis procedures for 
problems with hung terminals. Use this information if this problem occurs while 
you are using tso/vtam. This procedure will help you determine when the hang 
occurred and what was happening at that time. 

If the problem occurs during logon or logoff, get the recommended documentation 
and go to “Reporting Procedure” on page 68. 

The recommended documentation is: 


• vtam buffer contents trace. 

To see the data in the buffer contents trace, set conftxt = no in the tsokeyoo 
member of sys.i.parmlib before starting tso/vtam. 

• gtf trace of svc 93 and svc 94 entries. 

See the Debugging Handbook , Volume 1, for information on interpreting svc 93 
and svc 94 entries. 

• vtam internal trace with mode = ext and options api and piu. 

• tget/tput trace. 

The tget/tput trace records all tget/tput/tpg data except address space id 

TPUTS. 

You can get the tget/tput trace by issuing the modify trace command with 
type = tso. The modify command is described in VTAM Operation. 

• Dump of the nucleus, csa, and user's address space. 

If you think you might not be able to re-create the problem, take a dump before 
you try to clear the hang. 

If input (such as attn, reset, or enter) clears the hang, both a dump and traces 
may be necessary. You may want to start the traces, take a dump with the ter¬ 
minal hung, clear the hang, and then stop the traces. 

• Collect additional general information: 

- Try to determine if the error is related to a certain type of hardware or a 
certain protocol (sna or non-SNA). 

- Try to determine if the hang is related to a particular application program 
or type of application program (full-screen, graphics, and so on). 

If so, do other similar types of applications also hang? 
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1. Was the last data that was sent from the application program to vtam sent to 
the terminal before the hang occurred? 

To determine this, look for a vtam buffer contents trace entry that corresponds 
to the last tput trace entry. 

If you see these corresponding entries, the output was sent to the terminal. 

2. If the keyboard locked after data was sent to the terminal, check the outbound 
buffer contents trace entry for: 

• Bracketing indicators in rh byte 2 

• Change direction indicator in rh byte 2 

• Write control character to unlock the keyboard in byte 2 of the output 
request unit. 

If an end bracket was sent, the keyboard should be available. 

If a change direction was sent and the keyboard has been unlocked, the key¬ 
board should be available. 

If a tget is issued after a full-screen tput, tso/vtam should unlock the keyboard. 

3. If the keyboard has not been unlocked, see what kind of tput was issued last. 
(The option flag bytes in the tput entry show what kind of tput it is.) 

• For a noedit or tpg tput, tso/vtam will not unlock the keyboard. The appli¬ 
cation program is supposed to send a write control character to unlock the 
keyboard. 

• For other tput options, is a tget outstanding? 

If a tget is outstanding, tso/vtam is supposed to unlock the keyboard. 

If no tgets are outstanding, contact the group responsible for the applica¬ 
tion program. 

4. If the last activity prior to the hang was input from the terminal, was the data 
passed to the application program? (If it was, the tget trace entry will corre¬ 
spond to the inbound vtam buffer contents trace entry.) 

• If so, did the application program ever issue another tput? 

If the application program never issued another tput, contact the group 
responsible for the application program. 

• If not, is there anything on the output queue? (tvwaboq points to the first 
output queue element.) 

• If data has been received by tso/vtam, but it has not been sent to the ter¬ 
minal, go to “Reporting Procedure" on page 68. 

5. If you have not identified the problem, go to “Reporting Procedure” on 
page 68. 
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mvs Incorrect Output Problems 

Two main types of incorrect output problems are discussed in this section. Screen 
management problems involve mode errors, exception responses, and problems 
with the data on the screen. Screen size problems involve an incorrect or unex¬ 
pected screen size, either in a particular mode or all the time. Choose the one that 
is most like your symptoms and follow the procedure for that problem. 


mvs Screen Management Problems 

This section provides the documentation requirements and diagnosis procedures 
for problems displaying data on the screen. This section deals with five types of 
screen management problems: 

• Function error (incorrect screen management for mode) 

• Exception responses 

• Extra or missing data 

• Data is not placed correctly on the screen 

• Data appears to be translated incorrectly. 

Choose the one that most closely matches your symptoms and follow the proce¬ 
dure for that problem. 

Note: Problems with incorrect screen sizes are addressed in “mvsS creen Size 
Problems” on page 86. 

The recommended documentation is: 


• vtam buffer contents trace. 

To see the data in the buffer contents trace, set conftxt = no in the tsokeyoo 
member of sys.i.parmlib before starting tso/vtam. 

• gtf trace of svc 93 and svc 94 entries. 

See the Debugging Handbook , Volume 1, for information on interpreting svc 93 
and svc 94 entries. 

• tget/tput trace. 

The tget/tput trace records all tget/tput/tpg data except address space id 
tputs. 

You can get the tget/tput trace by issuing the modify trace command with 
type = tso. The modify command is described in VTAM Operation. 

• Dump of csa storage and the user's address space. 

This is only required for address space idtput errors. 
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mvs The Screen Functions Improperly for the Mode 

1. Review the svc 94 entries to determine the mode. The stfsmode and stlineno 
macros set full-screen mode on and off. 

• Full-screen mode. 

In full-screen mode, the application handles screen management. 

If the problem relates to full-screen processing, review the information on 
full-screen mode in the TSO Guide to Writing a Terminal Monitor Program . 

If this does not describe the full-screen processing that you are experi¬ 
encing, note the differences. 

• Line mode. 

In line mode, tso/vtam handles screen management. 

In line mode, the data generated by the application program is placed line 
by line down the screen, ready appears on the line below the data, and the 
cursor appears on the line below that. When the screen is full, tso/vtam 
sends a page prompt to the screen. When you press the enter key, 
tso/vtam clears the screen and sends any remaining data to the screen. 

If you enter data on the next to the last line of the screen, no page prompt 
is sent. Instead, tso/vtam clears the screen and reshows the data (or 
command) at the top of the screen. 

If this does not describe the line mode processing that you are experi¬ 
encing, note the differences. 

2. Report to the group (tso/vtam or the application program) that appears to be 
responsible for the incorrect screen management. 

mvs Exception Responses 

1. Does the error indicator reflect an error in the ru portion of the piu (sense = 
1003 or 1005)? 

If so, continue with this step. 

Otherwise, go to step 2. 

a. See what kind of tput was issued. (This is shown in the flag byte of the 
tput trace entry.) 

b. For a noedit tput, tso/vtam should not change the data provided by the 
application program. Compare the data in the tput trace, which starts at 
X'2C' into the trace record, with the vtam buffer contents trace. 

If tso/vtam has not changed the data, contact the group responsible for the 
application program that issued the tput. 

c. For a full-screen tput, was the data that is causing the error generated by 
the application program? (Data generated by the application program is 
present in the tput trace entry.) 

If so, contact the group responsible for the application program that issued 
the tput. 

If not, go to "Reporting Procedure” on page 68. 
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2. Look at the error sense code. 

If it is X 1 800A 1 , the piu is too long. This is probably a definition error. In this 
case: 

a. Look in the th portion of the buffer contents trace entry to find out the 
length of the piu that caused the error. 

b. See how maxdata is defined in your pccu definition statement. The 
maxdata value that you code should be as large as the largest piu that will 
be sent to the terminal by an application program. 

If you have more than one pccu definition statement, check to see that the 
right one is being used. 

3. If there are other error indicators, get the documentation shown in step 5 on 
page 59 and continue with that procedure. 

4. If you have not resolved the problem, go to "Reporting Procedure" on page 68. 

mvs Extra or Missing Data 

1. Is the problem with input (data received by the application)? 

a. Is too much data being passed to the application? 

• If previous input is added to the end of the current input, the modified 
data tags may have been set improperly in previous tputs. Go to the 
"Reporting Procedure" on page 68. 

• If the backspace key, character delete key, or line delete key is not 
functioning properly, look for SVC94 entries that may have changed the 
default in the stcc macro. 

If this does not account for the problem, get a dump of the nucleus, the 
csa, and the user's address space. Then go to “Reporting Procedure" 
on page 68. 

b. Is insufficient data being sent to the application program? 

• Find out which tget option was used, tso/vtam edits data sent from the 
terminal before it passes it to the application program. The type of 
editing that tso/vtam does depends on the tget option. Certain charac¬ 
ters may be deleted, such as control characters, aid characters, and 
set buffer address (sba) sequences. Look at the flag bytes in the tget 
trace entry to see which tget option was specified, tget options are 
described in the TSO Guide to Writing a Terminal Monitor Program. 

• Find out if any user edit exits are involved. User edit exits are listed in 
VTAM Installation and Resource Definition. 

• If you have not resolved the problem, go to “Reporting Procedure" on 
page 68. 
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2. Is the problem with output (data sent by the application)? 

a. Was extra data sent to the screen? 

tso/vtam should not generate any printable data. Compare the data 
portion of the tget/tput trace with the data in the vtam buffer contents 
trace. 

If you see printable data in the buffer contents trace that is not in the 
tget/tput trace, go to "Reporting Procedure" on page 68. 

If you see the same data in both traces, contact the group responsible for 
the application program that issued the tput. 

b. Was data from the application lost? 

tso/vtam does not generally delete data sent by the application program 
unless it is doing reshow processing. In reshow processing, tso/vtam 
deletes the full-screen tput and sends a reshow character (X' 6E') to the 
full-screen application program. This is shown in the tget trace entry. 
Compare the data portion of the tput trace entry with the data in the vtam 
buffer contents trace entry to see if any data has been deleted. Determine 
whether this is a tso/vtam problem or an application program error and 
contact the appropriate group. 

Note: For more information on reshow processing, see the TSO Guide to 
Writing a Terminai Monitor Program. 

3. If you have not resolved the problem, go to "Reporting Procedure" on page 68. 

mvs Data Is Misplaced on the Screen or Page 

1. Does data wrap around the screen? (Wrapping means that data fills the line 
and splits inappropriately between lines.) 

If it does, continue with this step. 

Otherwise, go to step 2. 

a. Find out which tput option was issued. Bytes X 1 12' and X 1 13' of the tput 
trace entry contain the option flags. 

b. For a noedit tput, tso/vtam does not edit data, and therefore does not 
change any sba sequences that may be issued by the application program. 
Contact the group responsible for the application program that issued the 

TPUT. 

c. For a full-screen tput, tso/vtam does not generate sba sequences to place 
the data on the screen, tso/vtam changes invalid buffer addresses to print¬ 
able characters (X'7A 1 ), but this would not cause the screen to wrap. 

If the symptom is incorrect screen size, go to "mvs Screen Size Problems" 
on page 86. 

Otherwise, contact the group responsible for the application program that 
issued the tput. 

d. If the data was sent without a full-screen or noedit option, go to "Reporting 
Procedure" on page 68. 
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2. If the problem is not on a display terminal, go to “Reporting Procedure” on 
page 68. 

3. Are sba sequences correct? Check the type of tput that was issued. Bytes 
X 1 12 ' and X' 13' of the tput trace entry contain the option flags. For full¬ 
screen and noedit tputs, the application program usually generates the sba 
sequences that determine where data is placed on the screen. 

4. Is the buffer address invalid? 

• If the buffer address is invalid for the screen size, contact the group 
responsible for the application program. 

• If an invalid buffer address (shown in the tput trace entry) is translated to a 
printable character (X'7A') t the data will go to an incorrect location on the 
screen. 

• If the buffer address is valid for the terminal in its present screen size, but 
was translated, go to “Reporting Procedure” on page 68. 

5. If this is the first non-full-screen tput following a full-screen tput, look for an 
svc 94 trace entry for stlineno. This macro may be issued by a full-screen 
application to indicate which line the next non-full-screen data should appear 
on. 

If the data was placed by the stlineno macro, contact the support group for the 
application program that issued the macro. 

6. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 

m s Data Appears To Be Translated Incorrectly 

Incorrect output is the main symptom of this problem. Sometimes the incorrect 
output is colons. The problem is probably related to the tput option that was speci¬ 
fied. 

1. Look at the option flag bytes (X 1 12' and X 1 13') in the tput trace entry to deter¬ 
mine what options were used. 

2. See the TSO Guide to Writing a Terminal Monitor Program to see what editing 
occurs for each type of tput option. 

3. If the incorrect output consists of colons, determine what data from the tput 
trace entry is being edited into the printable character X'7A' , a colon. 

4. See if tso/vtam is editing correctly. 

Note: Many applications use tput options that do extensive editing and trans¬ 
lation. This allows many different hardware devices to communicate with the 
application program without causing i/o errors. You may need to write your 
own user edit exits to make sure that all characters that are valid for your ter¬ 
minals appear on the screen, especially if you are using type 1 logical unit 
devices. 

5. If the editing does not appear to conform to the options specified, check for 
user edit exits or translation tables. (VTAM Installation and Resource Def/- 
nition has a list of these exits.) 

If you have exits or translation tables, verify that they are not causing the 
problem. 
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MVS 


6. Did the application program send incorrect data to vtam? The data is shown in 
the data portion of the tput trace entry. 

If so, the problem is in the application program. 

7. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 

Screen Size Problems 

This section provides documentation requirements and diagnosis procedures for 
screen size problems. Two major types of errors occur: 

• The screen never operates in the expected size 

• The screen is not always the expected size when you change modes. 

Choose the one that most closely matches your symptoms and follow the proce¬ 
dure for that problem. 

Recommended documentation includes: 


All of the traces may not be required. Read the diagnosis procedure before you 
get them. 

• vtam buffer contents trace. 

To see the data in the buffer contents trace, set conftxt-no in the tsokeyoo 
member of sys.i.parmlib before starting tso/vtam. 

• gtf trace of svc 93 and svc 94 entries. 

See the Debugging Handbook, Volume 1, for information on interpreting svc 93 
and svc 94 trace entries. 

• tget/tput trace. 

The tget/tput trace records all tget/tput/tpg data except address space id 

TPUTS. 

You can get the tget/tput trace by issuing the modify trace command with 
type—tso. The modify command is described in VTAM Operation. 
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mvs The Screen is Never the Expected Size 

This is probably a definition problem. 

1. If you are using a uss command to log on, try logging on without it. 

If this corrects the problem, review the use of the uss command in VTAM 
Customization and check the following: 

• Is the terminal a non-SNA 3270? 

If it is, does the uss command include a ussparm macro for the logmode? 

If so, vtam ignores the logmode name from the terminal definition state¬ 
ments and uses its own default bind image instead. 

• Does the uss command establish a default logmode name? 

If so, the default name overrides the name in the terminal definition state¬ 
ment. 

2. If this is not a uss command problem, check to see if the pservic operand of the 
modeent macro is coded correctly. VTAM Installation and Resource Definition 
explains how to do this. 

• Are primary and alternate sizes coded correctly? 

• For screen switching, is binpresz coded correctly as X'7F'? 

3. If you have not identified the problem, look at the bind that is sent. This is 
shown in a vtam buffer contents trace of the logon, or in a dump (get the user's 
address space, nucleus, and csa, and look at tsbxbind). 

• If the bind image is not what you expected, check the lu definition state¬ 
ment for an incorrect logmode or dlogmod parameter. 

• If no logmode table or dlogmod operand is specified, no pservic is passed 
to the tso/vtam logon exit routine. In this case, tso/vtam issues an inquire 
devchar macro and vtam indicates that the terminal is a logical unit. 
tso/vtam then uses the scrsize operand found in tsokeyoo. The default 
value for scrsize is 480 (12 rows and 40 columns). 

4. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 

mvs The Screen Is Not the Expected Size for the Mode 

Full-screen mode. The application program controls screen management in full¬ 
screen mode. The primary (small) screen size is considered by tso/vtam as the 
default size. The application program can control screen size by sending write 
commands in tputs that it issues. The write commands are X'F5\ erase write, and 
X'7E\ erase write alternate. The application program issues X'F5\ erase write, 
to set the primary screen size, or X'7E\ erase write alternate, to set the alternate 
(large) screen size. 

If neither size is issued, the screen will remain whatever size was in effect when 
the application program entered full-screen mode. 

Line mode, tso/vtam controls screen management in line mode. It generally uses 
the large (alternate) screen size when processing tputs in line mode. You can use 
the tso terminal command and stsize macro during a session to change the screen 
size for non-full-screen processing. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 4. mvs Procedures for TSO/VTAM Problems 87 



"Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Using output from the vtam buffer contents trace, the tget/tput trace for tso/vtam, 
and the gtf trace of the svc 93 and svc 94 entries, try to locate the source of the 
problem. 

1. Check the svc 94 trace entries to see whether the processing is in full-screen 
mode or line mode. The stfsmode and stlineno macros set these modes on 
and off. 

If the processing is in line mode, go to step 6. For full-screen mode, continue 
with step 2. 

2. Note if the incorrect screen size is related to entering or exiting full-screen 
mode. 

3. Locate the tput trace entry for the data that appears on the screen when the 
screen is the wrong size. Determine the tput options for this tput and the one 
that precedes it by looking at the option flag bytes. 

If either is a full-screen tput, look at the first data byte. 

If the first data byte is an escape character (X ’27'), the write command that 
follows has been specified by the application program. This write command 
should determine the screen size. 

If the write command is different in the buffer contents trace, go to “Reporting 
Procedure" on page 68. 

4. If there is not an escape character in the first data byte, is a write command 
(X’FI', X'7E\ or X'F5‘) provided? 

If one of these write commands exists, continue with this step. 

If not, go to the next step. 

If this write command is different in the vtam buffer contents trace, go to 
“Reporting Procedure" on page 68. 

If the same write command appears in both traces, contact the group respon¬ 
sible for the application program. 

5. If a write command is not provided in the tput data, and processing is in full¬ 
screen mode, does the write command generated by tso/vtam set the same 
screen size as the last write command provided by the full-screen application 
program? To determine this, compare the write command in the buffer con¬ 
tents trace entry with the last one provided in a tput trace entry. The write 
command is located in the data portion of the tput trace, at X'2C‘ into the 
entry. 

If the write commands are the same, go to "Reporting Procedure” on page 68. 

If the write commands are different, contact the group responsible for the appli¬ 
cation program. 

6. If processing is not in full-screen mode, did the stsize macro set the screen 
size? To determine this, look in the svc 94 trace entries. An entry code of 
X’OA' in the high order byte of register zero indicates that the stsize macro set 
the screen size. 

If the screen size was set by the application program, contact the group 
responsible for the application program. 

Otherwise, go to "Reporting Procedure" on page 68. 

7. If you have not resolved the problem, go to "Reporting Procedure” on page 68. 
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MVS Performance Problems 

This section provides documentation requirements and diagnosis procedures for 
performance problems. Use this section along with the information in “Perform¬ 
ance Procedure” on page 62. In addition to the documentation required in “Per¬ 
formance Procedure.” you will need: 


gtf trace of svc 93 and svc 94 entries. 

See the Debugging Handbook , Volume 1, for information on interpreting svc 93 and 
svc 94 trace entries. 


1. Are wait and hold options slowing response time? 

The application program may be issuing tputs and tgets with the wait or hold 
options. The wait option indicates that the application program should not 
regain control until output data has been placed on the output queue (tput) or 
input is available (tget). A tput with a hold option indicates that control should 
not be returned to the application until the data has reached the terminal. 

These options may be necessary for screen management, but prolong 
response time and increase the number of times the address space is 
swapped. 

2. Is an external system resource slowing response time? 

If all users must access the same resource, such as a system catalog, perform¬ 
ance deteriorates. This problem is especially severe when exclusive ENQs are 
used to control access to the resource. To improve performance, redistribute 
resources. 

3. Are high and low buffer extents set at inappropriate values? 

If the high and low buffer extents are too close together, output wait conditions 
occur. Buffer extents are specified in tsokeyoo, a member of sys.i.parmlib. 

Tune the values of the high and low buffer extents to get optimum perform¬ 
ance. Tuning is explained in VTAM Customization. 

4. Are appl definition statements coded correctly? 

Code the auth-nvpace operand on all appl definition statements for tso/vtam. 

If you do not set nvpace, vtam indicates that it has already received input data, 
instead of queuing the response until it receives the input data. Also, the swap 
count is incremented by two every time the enter key is pressed. 

5. Are pacing values set correctly for local sna terminals? 

vtam ignores the nvpace operand for sessions with logical units in a local 
major node. Therefore, you must set non-zero pacing values for these logical 
units. 

6. Is the mvs performance group specified correctly? 

Set the application program's performance group five to ten percent lower than 
vtam's performance group. To see the application program's performance 
group specification, look at the dispatching priority in the task's tcb. 

7. If you have not resolved the performance problem, go to “Performance 
Procedure” on page 62. 
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Chapter 5. vm Procedures for VSCS Problems 


vm Documentation You Should Collect for All VSCS Problems 

Always run vscs with one or more trace options active. The vscs console commu¬ 
nication services (ccs) trace option defaults to on and shows what is happening 
between vscs and ccs without significantly impacting system performance. (In 
vtam V3R1.2 and V3R2, the vscs vtam trace option also defaults to on.) When you 
need to re-create the problem, turn on all of the vscs trace options for the failing 
logical unit (lu), or for all logical units if the problem is not related to a specific 
logical unit. To prevent the trace table from wrapping, run traces externally or 
increase the size of the vscs internal trace table. For more information on setting 
the size of the trace table, see VTAM Installation and Resource Definition. 

When getting a vscs dump, use the dump formatting routine because control blocks 
are easier to locate in formatted output. 

When you report a problem, be prepared to provide the IBM Support Center with 
the following information: 


• vscs link map 

• vscs maintenance list 

• vscs dtiuser specifications (unless default parameters are used) 

• vm directory entries for vtam and vscs (if vscs is run in a separate virtual 
machine) 

• cp user-specified information in dmkrio, dmksys, and dmksnt (particularly for 
installation and performance problems) 

• gcs user-specific information (particularly for installation and performance 
problems) 

• vtam user-created logmode tables (particularly for logon and incorrect output 
problems). 


Note: If vscs dumps are enabled, and any vscs dumps were created prior to the 
problem you are reporting, please have those dumps available. 

‘vm General Procedures to Diagnose Logical Unit Hang Problems" on page 94 
and “vm Determining Device Characteristics" on page 97 explain how you can use 
the vscs display id luname command to determine the status of a particular logical 
unit. In some cases you can also determine where the problem is most likely to 
be, or which products are involved. This can help you determine the type of doc¬ 
umentation the ibm Support Center will require. 

“vm VM/SP Logo Problems on an SNA Device" on page 113 is another new diag¬ 
nostic procedure, introduced in V3Ri 2. 
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VM 


General Procedures to Diagnose Logical Unit Hang Problems 

If the problem is for one or more logical units, but not for all logical units, use the 
following commands to determine additional information as to where the problem 
is, from an external viewpoint: 

1. Issue a vscs display id- luname command. Use the display output to follow the 
steps below. 

a. Has vscs issued a vtam clsdst on the logical unit? If so, then the logical 
unit was not found. 

b. Is message dtissii displayed? If so, is this a “dialed” logical unit? 

c. Is message DTIS 66 I displayed? If so: 

• Note the current Presentation Services (ps) state of the logical unit. 

If the current state is one of the following— cip. clp, iip, invl. lgf, lip, lup, 
prg, or svr— then the logical unit is in an internal state and is waiting 
for another process to complete before continuing processing for this 
logical unit. 

If the current state is awl, vscs is waiting for an interrupt from the 
logical unit before displaying the vm/sp logo. 

If the current state is fss (full-screen support mode), then the applica¬ 
tion is responsible for restoring the keyboard, not vscs. If the applica¬ 
tion does not restore the keyboard, sna logical units are left in a hang 
condition and cannot be reset. 

• Determine which response mode is active for this logical unit. 

- Exception response mode (er; vtam V3R1.2 and later) 

- Definite response mode (dr; vtam V3R1.2 and later) 

Note: er/dr refers to the mode that is allowed for this logical unit, not 
the mode requested for the current operation. 

See the explanations of dtigen options in VTAM Installation and 
Resource Definition and VTAM Customization for more information on 
exception response mode. 

• Determine whether recovery is in progress for this logical unit. 

scip indicates that a network failure occurred and that vscs is 
attempting to reacquire the logical unit. 

rp indicates that recovery is pending, vscs is waiting for a response 
before initiating recovery for the logical unit (exception response mode 
only). 

rip indicates that recovery is in progress; vscs is attempting to recover 
the logical unit (exception response mode only). 

• Determine the current vtam Services (vs) state of the device. 

If the current state is term, then vscs is attempting to terminate the 
logical unit. 

If the current state is norm, then the logical unit has not been termi¬ 
nated. 
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d. Is message dtis 65I displayed? If so: 

• Does this message contain any iucv pathids? 

If so, then a cp connection is currently active. 

If this message just contains blanks, then a cp connection is not cur¬ 
rently active. 

• What is the current rpl command? 

• Is the send rpl currently busy? (vtam V3R1.2 and later) 

If so, then vscs is waiting for a vtam command to complete before 
doing anything else on the user's behalf. Several conditions can cause 
this to occur, including: 

- Missing i/o interrupt 

- Blocked pab in vtam 

— Network problem with device or routes to the device 

- sio never issued. 

Issue the vtam d net, routes test = yes to determine if the route is intact. 
If it is intact, you need vtam buffer use and line trace to determine 
whether the device responded to the last request. 

e. Is message otiss9i displayed? (vtam V3R1.2 and later) 

Note: This message will only be displayed if the receive specific option is 
active. 

If so, then is the receive specific rpl busy? 

If it is not busy, then vscs cannot receive any input from the logical unit. 
Normally, this occurs only when the device is being returned to vtam, is 
recovering from an error, or is processing input data for the logical unit. 

If the current ps state is awl, then the logical unit is hung, because vscs is 
waiting for an interrupt from the logical unit that will never be received. 

If a vscs internal error did not occur for this condition, then get a dump of 
the vscs virtual machine before recovering the logical unit by use of the 
vtam vary or vscs force command. 

f. Is message DTIS68I displayed? 

If so, then are the send or receive counts incrementing for the logical unit, 
or are both currently zero? 

If both are zero, you need additional information to determine whether the 
problem is in vscs or vtam. For example: 

1) If the problem occurred during logon, determine whether the device 
characteristics are correct for this logical unit. Check message DTIS651. 
If the current rpl command is opndst and the rpl is busy, determine 
why vtam is not not completing the request. 

2) If scip is included with message DTIS66I, determine why recovery of the 
logical unit is not completing. 

3) If the current rpl command in message DTIS65I is clsdst, and rpl is 
busy, determine why vtam is not completing the request. 
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2. Issue a cp query names to see if the logical unit name is still connected to the 
user id. 

3. If the user is still connected to cp, and the current ps state in message DTIS66I is 
not fss, dump the vscs virtual machine. Send a message to the hung user and 
see if that releases the logical unit. 

4. Issue a vscs query to determine: 

• The current vscs trace options that are active 

* The buffer status (lifo or fifo queuing). 

Note: If the logical unit has been hung for a while, the internal trace table has 
wrapped, unless the trace was running externally, or was running for only the 
logical unit in question. 
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Determining Device Characteristics 

To determine if the right vtam logmode entry was used, issue the vscs display 
iD = luname command. The resulting messages will indicate how the device char¬ 
acteristics appear to vscs. 

1. Is message DTIS 611 displayed? 

If so, note the device type: 3277, 3278, 3767, 2741, twx, or prt. 

Specifying the wrong vtam logmode entry, or using the vtam default logmode 
entry, leads to incorrect operation of the logical unit. In some cases, message 
DTIS99I from dtipiput will occur when input is received from the logical unit. 

Also note the device model. This determines the screen size that is used for 
display devices. (Screen size is displayed in message DTIS63I.) 

2. Is message DTIS62I displayed? 

If so, what is the logical unit type? 

0 Non-SNA display or printer device 

1 Keyboard/printer device 

2 sna display or printer device 

3 sna printer device. 

What are the device characteristics? 

• eds indicates that extended data stream commands are supported (for 
example, use of the Write Structured Field commands). 

• neds indicates that extended data stream commands are not supported. 

• apl indicates whether the device uses the new or old apl character set. 

• color indicates whether the device supports color. 

• shared indicates that the device is a shared printer. 

3. Is message DTIS63I displayed? 

Note: This message is issued for displays only. 

If so, note the screen size from the pservic field of the vtam logmode. 

Also note the alternate screen size from the pservic field of the vtam logmode 
(or, for some devices, from the Write Structured Field Query reply data). 

4. Is message DTIS64I displayed? 

Note: This message is issued for keyboard/printers only. 
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VM 


Symptoms of VSCS Problems 

This chapter divides vscs problems into the following general problem types. 

Note: Documentation requirements may differ if vscs is running in a separate 
virtual machine from vtam. It is also important to understand that vscs errors do 
not always result in a message, user disconnection, or user logoff. 

1. “ vm Initialization Problems” on page 101 

• Initialization never completes 

• vscs terminates immediately upon starting 

• A loop occurs during initialization 

• Other initialization problems. 

2. “ VMTermination Problems” on page 109 

• Termination never completes 

• vscs terminates prematurely 

• User's session terminates prematurely 

• Operator commands terminate vscs unexpectedly 

• Other termination problems. 

3. “vm Logon Problems” on page 115 

• First logon attempt fails 

• Logon never completes (logical unit is hung). 

4. “vm Logoff and Disconnect Problems” on page 117 

5. “ vm Wait and Loop Problems" on page 118 

• All vscs logical units are hung 

• One or more vscs logical units are hung. 

6. “vm Message Problems” on page 135 

• Message dtis99! indicates an internal error. 

7. “vm incorrect Output Problems” on page 138 

8. “vm Performance Problems” on page 143 

• Paging and storage problems 

• Slow response time on terminals. 

9. "vm other VSCS Problems” on page 144 

• sna dial problems 

• Printer sharing problems 

• Operator command is not processed properly. 
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vm Overview of Normal VSCS Initialization Process 

Below is an overview of what takes place during normal vscs initialization. This is 
the procedure that vscs follows each time it is initialized. Figure 20 shows the 
components involved in initialization. 

GCS processes iucv requests from vscs that affect path id setup and breakdown. 
iucv external interrupts are handled by gcs, which gives control to vscs after some 
validation is done. All other iucv requests and responses issued by vscs are 
handled directly by cp. 



Figure 20. vm Components Involved in VSCS Initialization 

1. vscs storage is initialized with dtiuserx, if specified. 

2. vscs issues message dticoii. 

3. vscs issues iucvini set to gcs. 

• gcs sets return code after processing request. 

4. vscs issues iucv query to cp. 

• cp responds with maxconn and eib size. 

5. If vscs trace is active, message DHS74I is issued. 

6. vscs issues global iucvcom connect and if successful: 

• cp provides path id and a return code back to gcs 

• gcs passes path id and a return code back to vscs 

• vscs issues a system wait at this point 

• cp generates an external interrupt for “connect complete” 

• gcs passes “connect complete” back to vscs 

• cp generates an external interrupt for vm/sp logos 

• gcs notifies vscs of a pending message. 

7. vscs issues iucv receive 

• vscs processes “connect complete" 

• iucv should be functional. 

• cp sends vm logo data to vscs. 

8. vscs processes vm logo information. 

9. vscs issues message DTIC 021 . 

10. vscs attaches vtam Services and Utility Services subtasks to gcs. 

11. vscs issues vtam open acb through gcs to VTAM. 
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12. vscs schedules a work element containing the vtam user id to Presentation Ser¬ 
vices. 

13. vscs issues message DTIV04I. 

• vtam interface should be functional; vscs is fully functional. 

14. vscs issues an iucv send to supply cp with the vtam user id. 
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vm Initialization Problems 

First you should look for initialization problems in these areas: 

1. A storage shortage could occur if: 

• vscs is in the same virtual machine as vtam in a large environment 

• vscs is in a small virtual machine 

• vscs dtigen parameters are incorrect 

- Trace table (too large for virtual machine size) 

- Printer table (too large for virtual machine size). 

• maxconn in the vm/sp directory entry for the vscs user id. 

2. Misspelled or missing parameters: vscs initialization uses most of the user 
parameters coded for: 

• CP 

• GCS 

• vtam appl definition 

• dtiuserx (if specified) 

• vm directory entry for the vscs virtual machine. 

3. Linking to the wrong disk for the vscs load module. 

4. The disk containing the vscs load module has changed since it was last 
accessed by this virtual machine. 

5. The vtam application program major node is inactive or invalid. 

6 . The wrong level of vtam is specified. 

7. The vm directory is incorrect (the user id for the iucv option card must be 
‘*ccs’). 

If none of the previous items is causing the problem, follow the procedure for your 
symptom: 

• Initialization never completes (a wait follows message dticoii or DTIS74I). 

• vscs terminates immediately upon starting. 

• A loop occurs (using 90 to 100% of cpu time). 

• Other initialization problems occur. 
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Initialization Never Completes (A Wait Follows Message DTIC01I) 

1. Is sna enabled? 

A delay during initialization is normal; vscs must wait for external interrupts for 
“connect complete” and the vm/sp logo. A long wait indicates a problem. 
enable sna is used to open a path from iucv to ccs, and if sna is disabled, then 
ccs will never process the connection request. 

Note: If sna is disabled and vscs started, it may appear that most operator 
commands do not complete. 

To make sure that sna has been enabled, use one of these cp commands: 

#CP ENABLE SNA 
#CP ENABLE ALL 
#CP ENABLE SNA User ID 

For more information on the enable command, see the CP Command Refer¬ 
ence. 

2. Are gcs and the vtam recovery machine active? 

Issue the gcs command query etrace to see if gcs is active. If it is not active, 
you will get the message “unknown cp/cms command.” To activate gcs, use the 
cp ipl gcs command. Use the cp query names command to see if the vtam 
recovery machine is active. If it is not active, you need to initialize it. 

3. Does gcs have control register 0 bit 30 on? 

To determine if control register 0 is set on, display the control registers from 
the vscs operator console (display X'O') or look in a dump of the vscs virtual 
machine (all registers are shown at the beginning of the dump), gcs must set 
the control register during gcs initialization in order to receive iucv external 
interrupts from cp. If control register 0 bit 30 is off, verify that the vscs direc¬ 
tory entry is correct (or the vtam directory entry, if vscs will run in the same 
virtual machine as vtam). Continue problem resolution with gcs. 

4. Did cp process the iucv connect request without error? ("Without error” means 
that no error messages were issued by cp, gcs, or vscs.) 

If so, continue with step 5. If not, the problem is in cp or gcs. 

This is shown in the cp internal trace entries X' 15' (iucv) and X' 16' (ccs) in the 
cp internal trace table. Before starting vscs, limit the amount of the external 
trace generated by issuing the cp command cptrap 15 16. For more informa¬ 
tion on the cp trace, see the VM/SP Operator's Guide. 

5. Did gcs reflect the external interrupts (for “connect complete” and the vm/sp 
logo) to vscs? 

To determine this, look at: 

• cp internal trace of iucv and ccs requests 

• gcs external trace of external interrupts received 

• vscs trace with ccs active. 

(See the VM/SP System Programmer’s Guide (for vm/sp R4), or the VM/SP 
Facility for System Programming (for vm/sp rs) for cptrap information. See the 
GCS Macro Reference for etrace information.) 

If gcs did not reflect the external interrupts to vscs, the problem is in gcs. 
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If all of these conditions are met, the iucv will be properly initialized and you 
will see message DTIC 021 . 

6. Was vscs previously active, and now cannot be restarted? 

If this is the case, the problem may arise from an abend or premature termi¬ 
nation (message dticozi) of vscs during the previous vscs initialization 
(assuming cp has not been reinitialized since then). If cp and gcs did not clean 
up after the abend, vscs cannot restart. Check the operator console listing to 
see if any problems were encountered on the previous termination. If there 
were problems, re-iPL gcs. If initialization still fails, re-iPL cp. 

7. If you do not have enough information, or cannot solve the problem, re-create 
the problem with the gcs. cp, and vscs traces active externally. Use your best 
judgment in trying to decide which product has the problem. If you suspect gcs 
or vscs is causing the problem, get a vscs dump. Otherwise, pursue the 
problem with cp. (See the CP Command Reference.) 

8. Go to “Reporting Procedure” on page 68. 

VM VSCS Terminates Immediately upon Starting 

1. How far did initialization go? 

Get the operator console listing, and use “ V m Overview of Normal VSCS Initial¬ 
ization Process” on page 99 to evaluate the console messages to see how far 
the initialization progressed, vscs messages that occur during successful 
initialization are dticoii, DTIC 021 , and DTIV04I in this order. 

Note: Messages issued for starting the vscs internal trace are not included 
here. 

If you did not get dticoii, the problem may be: 

• gcs is not active 

• vscs is not linked correctly 

• The vscs virtual machine is not large enough to hold the dtiistrt load 
module 

• Incorrect dtigen parameters. 

• gcs is dumping the vscs virtual machine. 

If you got dticoii but not DTIC 021 , the problem may be: 

• vm directory entry for the vscs virtual machine is wrong, or 

• cp or gcs found a problem (other than an abend) while processing an iucv 
request or response, vscs should issue a message to identify the failure 
and reason. See step 2 on page 104. 

• gcs is dumping the vscs virtual machine. 

If you got dticoii and DTIC 021 , but not dtivo4 |, the problem may be one of the fol¬ 
lowing: 

• vtam open acb error, (vtam return codes show what caused this.) 

• vtam appl definition is incorrect. 

• vtam appl definition is not active. 

• vtam storage shortage. 
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• vscs storage shortage. 

• vscs dtiuserx problem, such as incorrect parameters. (See “vm Other 
Initialization Problems” on page 107.) 

• gcs is dumping the vscs virtual machine. 

2. Was an error message issued? 

If so, try to find the source of the message. If not, go to step 5 on page 105. 

• cp messages begin with dmk 

• gcs messages begin with csi 

• cms messages begin with dms 

• vscs messages begin with dti 

• vtam messages begin with ist. 

If gcs issued the message, and it is not an abend, get a vscs dump. See “vm 
VSCS Dump” on page 155 for more information on the vscs dump. Then go to 
“Reporting Procedure” on page 68. 

3. Did you get an error message with a return code or iptype? 

If so, find the explanation for it, and determine what component issued the 
message. If not, go to step 4 on page 105. 

Figure 21 shows the source of return codes and iptypes. 


Message Source of IPTYPE or Return Code 


DTICxxx 

• 

• 

• 

GCS 

VM 

VSCS (very rarely) 

DTIIxxx 

• 

GCS 


• 

VSCS 

DTIPxxx 

• 

VM 


• 

VSCS (very rarely) 

DTISxxx 

• 

GCS 


• 

VSCS 

DTIVxxx 

• 

GCS 


• 

VSCS 


• 

VTAM 

Figure 21. 

VM Source of IPTYPE or Return Code During Initialization 


• If you got message dticosi with return code 878, then gcs had a getmain 
failure getting storage for an iucv request. See “vm Storage-Related 
Problems” on page 140 for more information. 

• If you got message DTIC 07 I with iptype = 03 , the previous termination did not 
complete, or two iucv connects with the same name have been issued from 
the same gcs group, iptype = 03 is an iucv sever request from cp, indicating 
cp is rejecting the connection request. 
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If you can re-create the problem, follow these steps: 

a. Use the dtigen options to activate vscs internal trace options, including 
the external trace option. 

b. Initiate cptrap. 

c. Start vscs using the newly created dtiuserx. 

d. After the failure occurs, stop cptrap. 

e. Process the cptrap output, which should contain the falling sequence. 

• If you got message dtico9I, you need to determine which component gener¬ 
ated the return code. See the GCS Macro Reference, the VM/SP System 
Programmer’s Guide (lor vm/sp R4 ), or the VM/SP Facility for System Pro¬ 
gramming (for vm/sp R5) for information on return codes and their 
meanings. 

• If you got a different error message, look in the GCS Macro Reference, the 
VM/SP System Programmer's Guide (for vm/sp R4 ), or the VM/SP Facility for 
System Programming (for vm/sp rs) for an explanation of the return code. 

If the message has an iptype, the iptype is one of the following: 

1 Pending Connection 

2 Connection Complete 

3 Severed Connection 

4 Quiesced Condition 

5 Resumed Connection 

6 Incoming Priority Reply 

7 Incoming Reply 

8 Incoming Priority Message 

9 Incoming Message. 

4. Did you get an error message without a return code or iptype? 

If so, does the message text adequately explain the problem? If you can fix the 
problem by correcting user-specified parameters, do so. If not, get the vm 
directory entry for the vscs virtual machine, vscs installation information, and 
gcs specified parameters. Then go to “Reporting Procedure” on page 68. 

Note: Figure 22 on page 106 shows all the vscs messages that can be issued 
for an initialization problem. 

5. Is the problem an abend? 

If an abend occurs during initialization, the problem is most likely caused by an 
error in the installation process of vscs. Find out how vscs was installed and 
linked. 

An abend (0C2) may also occur if one of the following is true: 

• vscs is not running in an authorized virtual machine. 

• The vscs appl definition does not specify authexit=yes. 

If an abend (706) was received before any vscs messages are displayed, then 
there was a failure linking the vscs load module. That failure left the load 
modul e “ non-executable." 

Otherwise, if the failure results from a link failure with a DTiusERn load module, 
message dtiiiii is issued. 
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If you cannot find and correct the error, get a vscs dump (created automatically 
for an abend) and go to “Reporting Procedure” on page 68. 

6. Is the problem something else? 

If you still cannot identify the problem, get a vscs dump and go to “Reporting 
Procedure” on page 68. The vscs dump is described in “vm VSCS Dump" on 
page 155. 


DTIC03I VSCS INITIALIZATION FAILED--INSUFFICIENT STORAGE AVAILABLE 

Note: The virtual machine is too small to initialize vscs or the dtigen parameters are specified 
incorrectly. 

DTIC04I VSCS INITIALIZATION FAILED-UNRECOVERABLE ERROR DETECTED 
DTIC05I VSCS INITIALIZATION FAILED--IUCVINI SET MACRO FAILED WITH RETURN CODE nn 
DTIC07I VSCS INITIALIZATION FAILED-GLOBAL CONNECT FAILURE, IPTYPE = nn 
DTIC09I IUCV GLOBAL CONNECT FAILURE, RETURN CODE = nn 
Note: This message is the result of an error from gcs or cp. 

DTH03I DTIITASK COMMUNICATION SERVICES INITIALIZATION FAILED. VSCS TERMINATING. 

DTI 1041 DTIITASK ATTACH FAILED FOR modname VSCS TERMINATING. 

DTM06I DTIITASK IDENTIFY FAILED FOR modname RETURN CODE = nn 

DTU14I modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INITIATED BY modname 
dti p 1 51 modname IUCV RECEIVE FAILURE, IUCV RETURN CODE = nn 
Note: cp provides the iucv return code. 

DTIS38I modname VSCS ABEND FOR (PS|VS|US) TASK - SYSTEM COMPLETION CODE = nn 

DTIS99I INTERNAL VSCS ERROR — modname n 

Note: If this happens during initialization and you have supplied a dtiuserx for initialization, it 
may be a dtiuserx specification error. 

dtivoii modname FAILURE FOR reqtype RETURN CODE = nn nn 

DTIV06I modname VSCS VTAM SERVICES INITIALIZATION FAILED, SHOWCB MACRO ERROR RTN 
CODES: R15 — nn R0 = nn 

DTIV07I modname VSCS INITIALIZATION FAILED-OPEN ACB FAILURE, ACBERFLG = nn 

DTIV09I modname VSCS VTAM SERVICES GENCB MACRO FAILURE FOR controlblkname RTN CODES: 
R15 = nn R0 = nn 

Figure 22. vm Messages Indicating VSCS Initialization Problems 
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vm A Loop Occurs During Initialization 

If 90 to 100% of cpu time is being used, and that is not a normal workload for the 
CPU, then the problem could be one of the following: 

• gcs is dumping the virtual machine. 

• A vtam temporary storage shortage has occurred, and vscs is trying the vtam 
request again. 

• vscs, vtam, or gcs may have a control block chained to itself, resulting in an 
infinite loop. 

• There is a loop in ccs or iucv, so that the vscs virtual machine appears to be 
looping, but is not. 

If vscs is running in the same virtual machine as vtam, it is very difficult to deter¬ 
mine where vscs is looping, because of the low priority at which vscs is running. If 
you are using the per trace to record the loop, the trace must run for at least one 
minute. 

If a dump message is issued, see “ vm VSCS Terminates Immediately upon 
Starting” on page 103 for information on how to proceed. 

1. Determine amount of storage available. 

To determine the amount of vtam storage available and which storage pools 
need to be enlarged, use either the sms (buffer use) trace or the vtam display 
bfruse command. These service aids are described in Chapter 7, “Using 
VTAM Service Aids." 

2. If you cannot find any errors from the display of the vtam buffer pools, collect 
this documentation: 

• A few seconds of the cp virtual machine branch trace (described in the CP 
Command Reference) 

• vscs dump 

• vscs operator console listing 

• vscs trace with ccs active, running before the loop started 

• vscs trace with any other options active, running before the loop started 

• Series of loop addresses obtained with the cp display psw command or 
from the cp virtual machine trace output. This command is described in 
the CP Command Reference . 

3. Go to “Reporting Procedure” on page 68. 

vm Other Initialization Problems 

1. Are parameters specified correctly in the dtigen macro? 

Figure 23 on page 108 shows messages issued for a problem involving incor¬ 
rect parameters. 

The parameter value representing the dtiuser number must be a number in the 
range 0-9, and one byte in length. If you do not get the correct dtiuserx 
module in message dtiiozi, re-access the vscsloadlib and make sure you enter 
this command correctly: 

VSCS START PARM=x (where x is the DTIUSER number) 
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If you are still experiencing problems, have an assembly listing of the dtigen 
macro available and go to “Reporting Procedure'’ on page 68. 


dti 1071 USING INITIALIZATION PARAMETERS IN CSECT csectname 

DTN 08 I INITIALIZATION CSECT csectname NOT FOUND 

DTI 1091 INVALID INITIALIZATION START PARAMETER 

dti 11 oi DEFAULT INITIALIZATION PARAMETERS BEING USED 

DTI 1111 LOAD OF INITIALIZATION CSECT DTIUSERx FAILED, 

LOAD ABEND CODE = yyy, REASON CODE = zzz 


Figure 23. VM VSCS Messages Useful in Analyzing a Parameter Problem 

2. Is vscs accessing the proper dtiuserx? 

If you see message dtiiioi, either you did not select the correct dtiuserx, or the 
loadlib containing the proper dtiuserx module is not accessible. Issue the cp 
query loadlib command and see if the correct loadlib is displayed in the query 
output. If the correct loadlib is not displayed, reissue the cp global loadlib 
command, specifying the proper loadlib and all of the other loadlibs displayed 
in the query output, then restart vscs again. Make sure the vscs loadlib con¬ 
tains the dtiuser you are trying to use. If you have verified that the dtiuserx is 
correct, and you still have problems, get the portion of the operator console 
listing showing vscs initialization and a list of the vscs loadlib. 

If you see message dtiiiii, then the requested dtiuserx was found, but an error 
occurred attempting to load it. Check the loadlib containing dtiuserx for 
errors. 

3. Go to “Reporting Procedure” on page 68. 
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vm Termination Problems 

vscs issues one of the following messages to indicate termination is in progress: 

DTI 1131 modname NORMAL TERMINATION OF VSCS HAS BEEN INITIATED BY 
mod2 

dti 1 141 modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INITI¬ 
ATED BY mod2 

The dti1 1 4i message is usually followed by a request for a dump. 

If you receive message DT 11131 , and you did not enter the vscs halt or quit operator 
command, and vtam is not terminating, check for previous vscs or vtam messages. 
They may indicate why termination is in progress. 

Problems during termination include: 

• “vm Termination Never Completes” 

• “vm VSCS Terminates Prematurely” on page 110 

• “vm User’s Session Terminates Prematurely” on page 111 

• “vm Operator Commands Terminate VSCS Unexpectedly” on page 112 

• “vm Other Termination Problems” on page 112. 

Choose the symptom most like yours and follow the procedure for that problem. 


vm Termination Never Completes 

1. Was termination initiated by a vscs operator command? 

If so, get a vscs dump and go to “Reporting Procedure” on page 68. If not, 
issue the vscs halt command. 

Note: If the vscs Utility Services subtask abended previously, normal termi¬ 
nation cannot take place, and you must issue the vscs cancel command to ter¬ 
minate vscs. 

2. Is vscs still in a wait state? 

Display all active sessions with the vtam display lu and vscs display id = luname 
commands. Issue a vtam vary inact command for each active session. This 
should allow vscs to continue the termination. If this does not complete termi¬ 
nation, use the vscs force id = luname command. 

3. Is termination still not completing? 

Get the following documentation: 

• vscs operator console listing 

• vscs dump (see 'Vm VSCS Dump” on page 155). 

Use the vscs cancel command to terminate vscs. 

4. Goto “Reporting Procedure” on page 68. 
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VM 


VSCS Terminates Prematurely 

1 . Did message DTIP151 appear? 

This indicates that Presentation Services caused the termination. Get the fol¬ 
lowing documentation: 

• vscs dumps, if available. (Generated by previous vscs abends or vscs 
internal errors) 

• vscs operator console listing showing any messages that tell which module 
invoked vscs termination. 

• Trace output from any vscs traces active at the time of vscs termination. 

Go to ‘‘Reporting Procedure” on page 68. 

2 . Did message dtivoii appear? 

If you got this message, issue a vtam bfruse command and see if the vtam crpl 
buffer pool has expanded. If the problem is not caused by buffer expansion, 
get the following documentation: 

• vscs vtam exit trace, if running at the time of the problem 

• A vscs dump. 

Go to ‘‘Reporting Procedure” on page 68. 

3. Did an abendoa 9 occur? 

This abend code indicates that vtam terminated while processing under control 
of the vscs vtam Services subtask. You must get this documentation: 

• vscs vtam exit trace if running at the time of the problem 

• The vscs dump created for any previous vscs abends. 

Go to ‘‘Reporting Procedure” on page 68. 

4. Did vscs terminate with abend code 878? 

If so, collect the following documentation: 

• The vscs dump created for the abend. 

• vscs global and storage control blocks. Process the vscs dump with 
prtdump, using vscs dump formatter options 1 and 2. That formats the vscs 
global and storage control blocks. 

• vtam storage shortage documentation. 

Goto ‘‘Reporting Procedure” on page 68. 

5. Did vscs terminate with another abend code? 

If recovery is possible, a message indicates that recovery is in progress and 
processing will continue. 

If recovery is not possible, vscs issues message dtiii4i and begins termination. 
Recovery cannot occur for these abend codes: 

QA8 GA9 122 13E 222 322 422 522 

All but 13E and 222 automatically produce a dump. 


110 


VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


In addition to this dump, get: 

• vscs trace with ccs active, at the time of the abend 

• vscs operator console listing showing messages around the time of the 
abend. 

Go to "Reporting Procedure” on page 68. 

6. Is there a storage shortage? 

A storage shortage can cause vscs to terminate. See “vm Storage-Related 
Problems” on page 140 for more information. 

7. Did any network failures just occur that involve vscs logical units? 

If so, and if scip recovery is specified for vscs, then both vscs and vtam require 
additional storage to perform recovery. 

8 . Is there a temporary vtam storage shortage? 

Use the vtam sms (buffer use) trace or the vtam display bfruse to determine if 
any vtam buffer pools are experiencing a shortage. These service aids are 
described in Chapter 7, “Using VTAM Service Aids.” See VTAM 
Customization for information on vtam buffer specifications. If you cannot 
resolve the problem by adjusting the depleted vtam buffer pools, go to 
“Reporting Procedure” on page 68. 

9. If you do not know the cause of the termination, collect the following documen¬ 
tation: 

• vscs dump 

• vscs operator console listing 

• Output from any traces active at the time of the problem. 

Go to “Reporting Procedure” on page 68. 


vm User’s Session Terminates Prematurely 

1. Are there any messages on the vscs operator console listing? 

Check the console for vscs messages indicating that the logical unit is being 
terminated, or has just been terminated. These messages may indicate a 
reason for the termination. 

2. Was a vtam vary inact, vscs force, or cp force command issued? If any of 
these operator commands were issued, vscs responded by terminating the 
logical unit. 

3. Did any errors occur during request processing for this device? If so, get the 
following documentation: 

• vscs trace running externally with all options active (except fre and get, 
for VTAM V3R2) 

• vtam internal trace, opt = (api.msg,piu), mode = ext. 

4. Did the termination occur right after a particular command was issued or a 
specific application program was started from a particular device type? If so, 
report the command or application program. 

If you can, re-create the problem with all vscs trace options active, and report 
that information. Otherwise, provide as many details as you can about the 
device you were using, and about the problem. 
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5. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 

Note: Use of exception response mode may increase the frequency of session 
terminations because of limited error recovery, which is considered normal 
operation for vtam V3R1.2 and later. 


vm Operator Commands Terminate VSCS Unexpectedly 

Do commands other than halt, cancel, or quit cause vscs to terminate? If so, note 
what these commands are. Get the operator console listing and any dumps that 
were produced, and go to “Reporting Procedure” on page 68. 


vm Other Termination Problems 

If you have a different problem with termination, or you do not know what the 
problem is, get: 

• vscs dump 

• vscs operator console listing 

• Output from any vscs traces that are active. 

Go to “Reporting Procedure” on page 68. 
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VM 


VM/SP Logo Problems on an SNA Device 

Before looking into potential problems in vscs logo processing, make sure that the 
logo appears correctly on a cp-controlled terminal. 

If you have modified the vm/sp logo, see if the default vm/sp logo works. If it does, 
that indicates that your modified may not be supported on vscs. 

See VTAM Customization for any vscs logo uniqueness. 

1. Logo lines shifted all over the screen and logo is not readable. 

a. Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display iD = luname command.) 

b. If vscs data exit (dtipddso) is coded, verify that the exit is not altering the 
start buffer addresses or the screen attributes in the outbound data stream. 

2. Only the online message is displayed. 

This indicates that both the normal logo and the alternate logo exceeded the 
capacity of the device. 

a. Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display iD = luname command.) 

b. Verify that either the normal or the alternate logo will fit on the screen size 
of the failing logical unit. 

3. Only a single-line logo is displayed. 

For vtam V3 R1.2 and V3R2, this indicates that the normal logo, online message, 
and command lines would not fit on the screen because of the width of each 
line, or because the number of lines allowed was exceeded. 

For vtam V3 R1.1, this indicates that the online message and logo body would not 
fit on the screen. 

a. Verify that either the normal or the alternate logo will fit on the screen size 
of the failing logical unit. 

b. Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display iD=luname command.) 

4. Only the online message and logo body are displayed, (vtam V3R1.1 only) 

Note: You must have vm/sp rs to get the command line fields. 

a. Verify that the normal logo body plus two lines (online message followed 
by a blank line) and the command lines will fit on the failing logical unit. 

b. Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display iD = luname command.) 

5. Screen colors or highlighting are incorrect or missing. 

a. Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display iD = luname command.) 

b. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 

c. If the vscs data exit (dtipddso) is coded, verify that it is not altering the start 
buffer addresses or the screen attributes in the outbound data stream. 
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6. The logo fields are unprotected. 

a. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 

b. Ensure that the embedded set attribute commands are paired (balanced) 
in the normal logo. 

c. If the vscs data exit (dtipddso) is coded, verify that it is not altering the start 
buffer addresses or the screen attributes in the outbound data stream. 

7. Command line problems. 

Note: Alteration of the command lines is not recommended. 

a. Cursor positioned wrong, or missing. 

The command lines provided by vm contain the Insert Cursor command. If 
this command is missing, then the cursor can be positioned anywhere. 

b. Command lines protected 

1) Ensure that the embedded set attribute commands are paired (bal¬ 
anced) in the normal logo. 

2) If the vscs data exit (dtipddso) is coded, verify that it is not altering the 
start buffer addresses or the screen attributes in the outbound data 
stream. 

c. Input from command lines results in incorrect input. 

1) Verify that the appropriate vtam logmode entry for the logical unit was 
used. (Use vscs display io=luname command.) 

2) If the vscs data exit (dtipddsi) is coded, verify that it is not altering the 
start buffer addresses in the data stream. 

Go to “Reporting Procedure” on page 68. 

If you decide to write your own logo, keep the following points in mind: 

• Changes to the vm/sp logo are considered to be user modifications. For vscs 
restrictions on altering the vm/sp logo, see VTAM Customization. 

• For vm/sp R5, user modification of the command lines is not recommended. 

• You cannot use the start buffer address (sba) or insert cursor (ic) commands 
when you modify the logo body. Other screen commands may not be accepted 
by all types of display devices, and vscs does not offer recovery procedures for 
any i/o errors that may result. 

• The default colors are white for the online message and blue for the logo body 
and input area. If you change the colors, you must start with the online 
message. If you use start field commands to control the colors, you must 
protect the online message and logo body. 
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Logon Problems 

1. Issue the vtam display and vscs display iD = luname commands and answer the 
following questions: 

• Does the session exist? 

• If the session exists, do the device characteristics match the logical unit 
characteristics? 

• If the rpl is busy, what is the current rpl command? 

See ‘‘vm General Procedures to Diagnose Logical Unit Hang Problems" on 
page 94 and "vm Determining Device Characteristics” on page 97 for more 
information. 

2. Are you logging on to vscs for the first time? 

If so, and if you are not using the VTAM-supplied logmode entries, the logmode 
entries are probably incorrect. If you are logging on from an mvs or vse host, 
that host must provide customized logmode entries. Review the process for 
building your own modtab and logmode entries in VTAM Customization (vscs 
requirements in the pservic field). 

3. Are you trying to log on in logo mode? 

When you first turn on the power for your terminal, the vm/sp logo appears on 
the screen. To log on, press enter, the pai or PA2 key, and start your input. 

Note: With vm/sp R5, command lines are included as part of the logo, which 
allows you to log on directly from the logo screen. 

If you cannot log on in logo mode, try logging on in no-logo mode. If the 
problem still exists, you are probably using the wrong logmode entry. (See 
"vm Determining Device Characteristics" on page 97.) 

If the problem goes away, a user-designed logo may be causing the problem. 
(See "vm VM/SP Logo Problems on an SNA Device" on page 113.) 

To pursue the problem further, collect the following documentation: 

• vscs trace for the failing logical unit with all options active (except fre and 

GET, for VTAM V3R2) 

• vtam internal trace, opt = api 

• vtam buffer contents trace for the failing logical unit 

• Output from the vscs display id = luname command, if possible 

• Description of what is on the screen 

• The vscs console log. 

4. Did you get message dtipui with a return code indicating that the iucv global 
path is severed? 

If so, go to page 120. 

If not, issue vmexit. That should return the logical unit to vtam. Then issue the 
vscs display command. If the logical unit is not found, the problem is with cp. 
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5. Is the terminal hung? 

• If so, was the vm/sp logo removed from the screen? 

- If so, the documentation you need is: 

— vscs trace for the failing logical unit with all options active (except 
FRE and GET, for VTAM V3R2) 

— vtam internal trace, opt = api 

— vtam buffer contents trace for the failing logical unit 
— The vscs console log. 

- If not, go to step 3. 

• If not, is the vm/sp logo or vtam ussmsgio on the screen? 

- If so, the documentation you need is: 

— vscs trace for the failing logical unit with all options active (except 
FRE and GET, for VTAM V3R2) 

— vtam internal trace, opt = api 

— vtam buffer contents trace for the failing logical unit 
— The vscs console log. 

- If not, go to step 6. 

6. Get other documentation. 

In addition to any documentation you have collected so far, get the vscs ccs 
and vtam exit trace for the failing logical unit. 

7. Are all terminals hung? 

If so, go to ‘ vmAII VSCS Logical Units Are Hung (Affects Logons and Current 
Sessions)” on page 119. 

8. Goto “Reporting Procedure” on page 68. 
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vm Logoff and Disconnect Problems 

If the terminal is hung, go to page 129. 

1. Record the status of the terminal. For example, on a display screen, note what 
is in the status area, the last input or the last output to the logical unit. 

2. Issue the cp query names command and note whether the logical unit name is 
known to cp. 

3. Issue the vtam display and vscs display id = luname commands and note the fol¬ 
lowing: 

• Whether the session exists 

• The current rpl command 

• Whether the rpl is busy (for vtam V3R1.2 and later). 

See ‘ vm General Procedures to Diagnose Logical Unit Hang Problems” on 
page 94 for more information. 

4. Collect more documentation: 

• Device type, model, and current state (use vscs display id = luname) 

• ccs and vtam trace output 

• Any other vscs trace output available 

• vscs dump. 

Note: The vscs dump formatter will print a single logical unit on request. 

5. Find the logical unit control blocks in the vscs dump and look at the following: 

a. The current state of each logical unit. It will be plb lbcstate or vlb 
lbcstate. VTAM Data Areas describes these states in more detail. 

b. What is the status of the send rpl? Note whether it is busy, and note 
whether it contains any errors. 

c. Note whether the logical unit has any work to process. This is indicated by 
the existence of dtiwebs in the dump. 

6. After collecting all documentation, go to “Reporting Procedure” on page 68. 
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VM Wait and Loop Problems 

Complete the preliminary procedure below, and if the problem persists, choose the 
symptom that most closely matches yours. Follow the procedure given for your 
symptom. 

• “vm All VSCS Logical Units Are Hung (Affects Logons and Current Sessions)” 
on page 119 

• “vm One or More Logical Units Hung” on page 123 

• “vm VSCS Operator Commands Do Not Complete” on page 134. 

Note: The term “hung terminal” means the user is prevented by the system from 
entering data. 

vm Preliminary Procedure for Problems Involving All Logical Units 

This is a fairly short procedure that can help you isolate some common reasons 
that cause all logical units to hang. 

1. Is vscs dispatchable? 

Use the following commands to see if vscs can process anything: 

• Does vscs respond to the vscs query command? 

• Does 'vsm' show up when the cp query names command is issued? 

• Does vtam respond to the vtam display commands? 

If the answer to all three questions is yes, vscs is dispatchable and the global 
iucv connection is intact. Continue with step 2 . 

If one or more answers is no, the problem could be one of the following: 

• A higher-priority task is looping 

• vscs is looping 

• vscs (or gcs) is waiting for an iucv instruction to complete. 

If the loop or wait occurs during initialization, go to “vm Initialization Problems” 
on page 101. 

If the problem occurs during termination, go to “vm Termination Problems” on 
page 109. 

If the problem occurs during logon, go to “vm Logon Problems” on page 115. 

If the problem occurs during logoff, go to “vm Logoff and Disconnect Problems” 
on page 117. Get a vscs dump (see step 3), and go to “Reporting Procedure” 
on page 68. 

Note: If a vscs dump is in progress, it will appear that all users are hung and 
no console commands will complete. When the dump has completed, proc¬ 
essing will resume. 

2. Look at operator console output. 

The vscs, vtam, and cp console listings may contain messages that explain 
your present condition. Check for vscs or vtam messages that indicate that a 
network failure occurred and error recovery is in progress. For example, 
message dtis3ii might tell you that vscs is taking a dump. 
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3. Get a vscs dump and a vscs internal trace. 

If a dump is not in progress and the vscs console does not respond to com¬ 
mands issued in “running” status, use the cp dump command in cp mode. For 
more information on the vscs dump, see vm VSCS Dump” on page 155. For 
more information on cp operator commands, see the CP Command Reference. 
Get the vscs internal trace before recovering the logical unit if possible. 

4. Examine the logical unit control blocks and trace output. 

In the dump, find the logical unit control blocks tab, plb, and vlb. The vscs 
internal trace, used along with information from the control blocks, may show 
the reason for the hang. 

Note: The vtam vary inact, vscs force, and cp force commands turn bits on 
and off in the plb and vlb. Those bits are used to determine the reason for a 
hung logical unit. Therefore, attempt to gather documentation before using 
those commands, unless you suspect one of them is the cause of the problem. 

5. Is it a network problem? 

A network problem, such as vtam failing to terminate a session successfully, or 
outstanding i/o, may cause logical units to hang. To diagnose vtam problems, 
see Chapter 3, "Procedures for Specific Problem Types.” 

Note: Before determining that the problem is a vscs problem, issue the vscs 
display id = luname to determine whether i/o is active (rpl is busy; vtam V3R1.2 
and later). 

VM All VSCS Logical Units Are Hung (Affects Logons and Current Sessions) 

If all vscs logical units are hung, the problem is likely to be in one of the following 
four areas: 


Problem 

Symptoms 

Global IUCV path severed 

• 

VSCS issues great quantities of DTI messages 


• 

Users cannot log on (DTIVI21) 


• 

Message DTIP14I. 

VTAM Services task 

• 

Wait 

problem 

• 

VTAM Services save areas show that a VTAM 
request is being processed. 

Presentation Services in a 

• 

Loop symptoms 

large enabled loop 


- Response time is slower than normal 

- 90 to 100% of CPU time is used 

- VSCS console does not respond 


• 

All VIT entries are the same. 

No VTAM RECEIVE ANY 

• 

Message DTIV05I 

RPLs active 

• 

VSCS dump shows inactive RPLs. 


It can be difficult to determine whether vscs is the cause of a loop. The loop can be 
caused by one of the following: 

• vtam is recovering from a network failure (if vscs is in the same virtual 
machine as vtam). 

• vscs is in scip recovery after a network failure. 
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• gcs is dumping the virtual machine. 

• A vtam temporary storage shortage has occurred, and vscs is trying the vtam 
request again. 

• vscs. vtam, or gcs may have a control block chained to itself, resulting in an 
infinite loop. 

• There is a loop in ccs or iucv, so that the vscs virtual machine appears to be 
looping, but is not. 

Note: Check the vscs console log to see if error recovery is in progress. 

Choose the problem most like yours and follow the procedure for it. 

vm Global IUCV Path is Severed 

1. Determine whether the iucv path is severed. 

a. Issue cp query names. If you do not see a “vsm” followed by names, then 
the global path is probably severed. Go to step 2. 

b. vscs issues many dtixxxx messages because all attempts to communicate 
with cp are rejected. Look at the iptype or return codes in these messages 
(a list of iptypes is shown on page 105). If the iptype or return code indi¬ 
cates that the iucv path is not active, or that the path id is invalid, go to step 

2. vscs issues message dtipui with a reason code indicating why the 
logical unit cannot connect with cp. If the reason code indicates that the 
iucv path is not active, or that the path id is invalid, go to step 2. 

2. If you have determined that the vscs global path is severed, get data from the 
vscs ccs trace and any vscs internal error dumps taken. Get the documenta¬ 
tion if available, and then go to “Reporting Procedure” on page 68. 

Note: vscs dumps must be enabled at the time of the iucv sever request to get 
the required documentation. 

vm VTAM Services Task Problems 

1. Is vscs in a wait? 

Because vscs uses both synchronous and asynchronous processing, timing 
problems can cause a wait. A wait condition could indicate a problem in the 
vscs vtam Services subtask. 

2. Is a request presently being processed? 

Find the vtam Services save areas and determine if a vtam request is presently 
being processed. If vtam does not complete a request, all vscs terminals will 
be hung. 

3. If the problem is in vtam Services, collect the following documentation and go 
to “Reporting Procedure” on page 68: 

• vscs dump 

• vscs operator console listing 

• vscs ccs and vtam exit traces active externally 

• vtam internal trace, opt=(api,msg.piu), mode = ext 

• vtam dump (use gdump command), unless vscs is in the same virtual 
machine. 
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vm Presentation Services is in a Large Enabled Loop 

1. Is vscs showing symptoms of a loop? 

These symptoms are typical of a loop problem: 

• Extremely slow response time 

• 90 to 100% of cpu time used 

• vscs console does not respond. 

2. Do any vscs trace entries indicate a loop? 

Look at the vscs internal trace table on the screen or in a dump and see if all of 
the trace entries are the same. (See " vm VSCS Trace Facility” on page 159 for 
a description of the vscs trace records). If so, the vscs ccs trace entries could 
indicate if vscs or cp is continuously sending iucv requests or replies. The vscs 
dispatcher trace entries show whether vscs is in an internal loop processing a 
single work element. 

On the screen, use the vscs query command (see VTAM Operation) to find the 
starting address of the vscs internal trace table. Then display the address of 
the current entry with the command 

D xxxxxx.20 

where xxxxxx is the current trace entry (the vscs trace table address +8 is the 
address of the current entry). Record what you see. Wait a minute or two and 
repeat the procedure above. If the vscs trace entries are the same, and only 
the vscs ccs trace is active, then vscs is in a loop, vscs is waiting for an event 
to complete, or there is currently no work to process. 

To find the internal trace table in a dump, use the pointer at sabtrhdr in the 
dtisab. If vscs is in a loop, the current and preceding trace entries may look 
the same, depending on the trace options that are active. 

3. Find the current logical unit. 

You can find the logical unit being processed by Presentation Services in the 
current (last used) entry in the vscs internal trace table. 

4. Use the dispatcher trace to verify the loop. 

If vscs is looping on one work element block (dtiweb), you will see it re¬ 
dispatched for the same logical unit over and over. For information on the dis¬ 
patcher trace, see “ vm VSCS Trace Facility” on page 159. 

Note: If you limit the number of users on the system at the time of the loop, the 
extent of the loop may be more apparent in the save areas. 

5. Examine the dispatcher work element queue in a vscs dump. 

The Presentation Services dispatcher work element queue is located in module 
dtiisdai in a dump. The address of this module in a dump is shown in the vscs 
trace table header and in the link-edit listing. If the queue shows a long chain 
of work to do, vscs may be in a loop or a permanent wait. If so, the problem 
will be associated with the current user identified by the dispatcher. 

6. Get the following documentation: 

7. If so, the documentation you need is: 

• vscs trace for the failing logical unit with all options active (except fre and 

GET, for VTAM V3R2) 

• vtam internal trace, opt-(api.msg.piu), mode = ext. 
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• A few seconds of virtual machine branch trace on the vsm, to trace only the 
vscs address range. 

The beginning of the vscs load module can be found by use of the vscs 
query command (if vscs trace is active). Message DTIS74I contains the 
starting address of the vscs trace table. Use cp display txxxxx.so and VTAM 
Data Areas to find the addresses in the thdrstrt and thdrsda2 fields. 

Those addresses represent the extent of the vscs load module. 

Note: Use the per instruction to trace only address ranges of vscs that you 
want to trace. (For more information on the branch trace, see the CP 
Command Reference.) 

• vscs dump 

• vscs operator console listing. 

8. Goto “Reporting Procedure” on page 68. 

No VTAM RECEIVE ANY RPLs Active 

1. Did you get message DTIV05I? 

vscs maintains a pool of receive any rpls, which are used by the receive rpl 
exit to receive data from vtam for all vscs logical units, vscs monitors the 
number of active receive any rpls. If none of the rpls are active, vscs cannot 
receive data from vtam. vscs issues message dtivosi for this error condition. If 
you received this message, go to step 3. 

Under certain error conditions, however, the receive any is not issued, and 
vscs runs out of receive any rpls without issuing dtivosi. Then vscs cannot 
communicate with vtam. 

2. Look for the rpl pool in a dump. 

To check for this condition, look for the rpls in a dump using this method: 

a. Find dtiisdai. 

b. Locate the dtivgb contained in dtiisdai. 

c. Locate the receive any rpls. 

dtivgb + X' 18 1 is the address of the 1st receive any rpl. 
dtivgb + X'lC' is the address of the 2nd receive any rpl. 
dtivgb + X'20 1 is the address of the 3rd receive any rpl. 

Keep adding X' 4 ’ to the previous address to find the next receive any rpl. 

The total number of receive any rpls is controlled by the dtigen parameter 
rplnum. The default is 8, but rplnum can range from 3 to 16. dtivgb contains 
the address of each receive any rpl. 

Under normal conditions, all rpls are active. Check the rplactiv field of the 
rpl. If rplactiv is X‘FF\ then the rpl is active. 

If rplactiv is not X' FF 1 , then the rpl is temporarily inactive, most likely 
because one of the vtam Services exits is currently working with it, or vtam is 
momentarily using it. Check the vscs vtam Services save areas to see what is 
being processed. The rpl command code is usually X'23', but it can be X'22' 
or X'24 1 when used by the rpl exits. The command code is in the rplreq field 
of the rpl. 
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3. If receive any rpls are inactive, get the following documentation: 

• vtam internal trace, opt = api.msg.piu; active externally 

• vscs vtam exit trace 

• vscs dump 

• vscs operator console listing. 

4. Goto "Reporting Procedure” on page 68. 

vm One or More Logical Units Hung 

If a single terminal is hung, follow these steps: 

1. Use the “vm General Procedures to Diagnose Logical Unit Hang Problems” on 
page 94. 

2. Get the required documentation from “ v m Determine When the Hang 
Occurred.” 

3. Try to clear the hang. 

• For local non-SNA vscs terminals, press the reset key. 

• For remote vscs terminals, do one of the following: 

1. Turn the power off, then on. 

2. Use the test on/off switch. 

3. For sna logical units, press the alt and sys req keys, then enter logoff to 

VTAM. 

4. Press the attn key. 

5. Have the operator issue one or more of the following commands from the 
vm or vtam console: 

- vtam vary inact.f.id = Iuname 

- vtam vary inact,i,id= luname 

- vscs force id = luname 

- cp force userid 

vm Determine When the Hang Occurred 

Choose from the following list the description that most closely matches your situ¬ 
ation, and go to that procedure. 

Q Logical unit hangs while using a full-screen application program, such as 
spf or xedit (see page 124). 

Q Logical unit hangs while using console mode or cms mode (see page 126). 

Q Logical unit hangs while moving between full-screen mode and console or 

cms mode (see page 128). 

□ Logical unit hangs after error condition during purge, logoff, or cleanup. 
This may be indicated by a message (see page 129). 

Q Logical unit hangs after message dticioi because the path is already 
severed (see page 131). 

Q Logical unit remains hung after using vtam vary inact, vscs force, or cp 
force commands (see page 132). 

Q Other (see page 133). 
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Q Logical Unit Hangs While You Are Using Full-Screen Mode or the Logical Unit 
Is Dialed 

1. Is a full-screen application program (such as xedit or spf) responsible for the 
failure? 

In full-screen mode, the application program is responsible for formatting the 
screen, unlocking the keyboard, and reading input data. If the application 
program does not handle these functions properly, the device can be hung. 

Indications of this are: 

• progxxx message 

• Message limit is reached 

• Message ‘not accepted’ appears when you press the enter key. 

This indicates that the application issued a write with keyboard restore, but 
did not retry the previous data. 

• The keyboard is locked. 

If you have indications of a full-screen application program failure, get a dump 
of the user’s virtual machine and go to “Reporting Procedure” on page 68. 

2. Is the logmode defined incorrectly? 

Signs of this are: 

• Invalid characters appear on the screen. 

• The colors are wrong. 

• The screen size is wrong. 

• The logical unit is disconnected. 

Use the vscs command display iD = luname to see if the device is defined cor¬ 
rectly. (See “VM Determining Device Characteristics” on page 97 for more 
information.) If the logmode is defined incorrectly, see VTAM Customization 
and correct the logmode definition. 

If logmode is correct, continue with this procedure. 

3. Did an opcheck occur? 

Signs of this are: 

• The application program ends. 

• The output for a color display shows the wrong colors. 

• The logical unit is disconnected. 

If opcheck conditions exist, get the vscs ccs trace and vtam buffer contents 
trace on the failing logical unit for documentation. 

Go to “Reporting Procedure” on page 68. 

4. Is the logical unit hung or data lost after a cp message was displayed or input 
was entered? 

While a logical unit is in full-screen state, vscs should display no cp messages 
(except warnings and priority messages) until input is received (at which time 
the full-screen application is notified of input available). 
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If dtigen option fsread = n has been coded, then you can expect loss of data: 

• If the screen is interrupted before input is received from the logical unit 

• If modified data input is available, cp messages were displayed, and the 
buffer data is requested by the full screen application. 

Note: The full-screen application program is responsible for restoring the key¬ 
board after input is received. If the keyboard is not restored, the logical unit 
remains hung. 

Get the vscs trace with ccs, disp, and vtam active, and a vscs dump. (See “vm 
VSCS Trace Facility” on page 159 and “vm VSCS Dump” on page 155 for more 
information on getting this output.) 

Go to “Reporting Procedure” on page 68. 

5. Is the logical unit still hung? If so, get this documentation: 

• vscs ccs, disp, and vtam exit traces for the failing logical unit 

• vscs dump 

• vtam sms (buffer use) trace for the failing logical unit. 

Go to “Reporting Procedure” on page 68. 
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Q Logical Unit Hangs While You Are Using Console Mode or cms Mode 
Note: The cms full-screen command puts the logical unit into full-screen state. 

1. is the logical unit waiting for the previous command to be displayed again? 

If so, then one of the following occurred: 

• The command has not completed and cp did not notify vscs (via command 
completion or timer expiration) to display the input again. 

• The command was executed by the full-screen application program and the 
application did not display the information again. 

• The input has not been accepted. 

Get a vscs ccs trace for the failing logical unit and a vscs dump. Then go to 
“Reporting Procedure” on page 68. 

2. Is the logical unit hung after a ‘more’, ‘holding’, or 'not accepted’ condition? 

If so, get a vscs dump and the vscs ccs and dispatcher traces. Then go to 
“Reporting Procedure” on page 68. 

3. Are the vscs data translation exits coded? 

The following vscs user exits affect the logical units’ reaction to any outbound 
data streams and cp’s reaction to inbound data streams: 

dtipdnti lui inbound data 

dtipdnto lui outbound data 

dtipddsi display input data 

dtipodso display outbound data. 

If the problem does not appear to be a problem in the user-coded exit, get the 
following documentation: 

• vscs ccs trace 

• VSCS DATA trace (V3R2) 

• vtam buffer contents trace for the failing lu. 

Go to “Reporting Procedure" on page 68. 

4. is the problem with a 3279 color terminal (type 0 logical unit)? 

Make sure featur2=edats is specified in one or more of these ncp definitions: 

line 

group 

CLUSTER 

TERMINAL. 

Also, check the coding of the user exits (dtipddsi and dtipddso). 

If color or highlighting still does not work correctly, get the following documen¬ 
tation: 

• vscs ccs and vtam exit traces, and data for the failing logical unit 

• vtam buffer contents trace for the failing logical unit. 

Go to “Reporting Procedure” on page 68. 
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5. Is the device dialed to another system? 

If so, go to the full-screen procedure on page 124. 

Note: Dialing to pvm and passing through to another cms system gives the 
appearance of normal console and cms screens. However, vscs receives the 
entire screen already formatted, including the status area, and processes the 
data as full-screen data. 

6. Documentation for problems not described above: 

If you can re-create the problem, get: 

• vscs trace for the failing logical unit with all options active (except fre and 
GET, for VTAM V3R2) 

• vscs dump 

• vtam internal trace with 0PT=(APi,MSG,Riu,PSS t sscp), mode=ext 

• vtam buffer contents trace for failing logical unit. 

If you cannot re-create the problem, get: 

• vscs trace with ccs active, for just the failing logical unit, if possible 

• vscs dump 

• vtam logmode being used. 

Go to “Reporting Procedure” on page 68. 
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B Logical Unit Hangs When You Switch Modes 

1. Does your terminal hang when you switch between modes? For example: 

• Console mode to cms mode 

• cms mode to console mode 

• cms or console mode to full-screen mode 

• Full-screen mode to cms or console mode. 

2. If so, get the following documentation: 

If you can re-create the problem, get: 

• vscsdump 

• vtam buffer contents trace 

• vscs ccs and dispatcher traces with just the failing logical unit traced 

• vtam internal trace with opt=(api,msg,piu,pss,sscp), mode=ext. 

If you cannot re-create the problem, get at least: 

• vscsdump 

• vscs trace with ccs and disp active. 

3. Go to "Reporting Procedure” on page 68. 
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Q Logical Unit Hangs During Logoff or Disconnect Processing 

1. Have any messages been issued? 

Get the operator console log and look for messages that pertain to the hang. 

2. Determine the component that sent the message. 

If the message has a return code, use Figure 24 to determine the component 
that may have sent the message. Then look in VTAM Messages and Codes to 
see what the return code means. 

If the message has no return code, use the message prefix to determine where 
the message is coming from. Page 104 has a list of the message prefixes for 
each component. 


Message 

Source of Return Codes 

DTIPxxx 

GCS 


VM 


vscs 

DTISxxx 

VM 


VSCS 

DTIVxxx 

VTAM 


Figure 24. vm Source of Return Codes 

3. Are other components connected to the logical unit? 

Answering these questions may indicate which components are still communi¬ 
cating with the logical unit. 

• Does the vscs command display id = luname show the status of the device? 
(See " vm Determining Device Characteristics” on page 97 for more infor¬ 
mation.) 

• Is the user still logged on to vm? Try the cp query names command. If the 
logical unit name and user id appear, the logical unit is connected to vm 
and the cp iucv connection is intact. If the response is gibberish, the 
logical unit is not connected to vm and the cp iucv connection has been 
severed. 

• Does vtam show the logical unit still in session with vscs? (Use the vtam 
display command.) 

4. Note the status of the logical unit at this time. For example, on a display 
screen note what is in the status area, and what was the last input or the last 
output to the logical unit. 
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5. Collect documentation before recovery. 

If you can re-create the problem, get: 

• vscs dump 

• vtam buffer contents trace 

• vscs trace for the failing logical unit with all options active (except fre and 
GET, for VTAM V3R2). 

If you cannot re-create the problem, get: 

• vscs dump 

• vscs trace with ccs active. 

6. Recover the logical unit with one or more of these commands: 

• CP FORCE 

• VTAM VARY INACT 

• VSCS FORCE. 

7. Go to “Reporting Procedure” on page 68. 
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El Logical Unit Hangs After Receiving Message dticioi 

1. Did these symptoms occur? 

Message dticioi indicates that an iucv request or response was received on the 
global path after an iucv sever was issued by vscs. Most of the time this does 
not cause a problem, because cp logs off or disconnects the logical unit when 
the iucv sever is processed. If it is a problem, it could produce these symp¬ 
toms: 

• Abend or program check 

• vscs message dtiii4I 

• Loss of operator communications. 

• Message CSUXT413T indicates that the signal services path was severed. 

2. Collect documentation. 

• vscs dump 

• vscs trace with ccs active, running for all logical units. 

3. Go to “Reporting Procedure” on page 68. 
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H Logical Unit Stays Hung After You Use vary inact or force Command 

1. Try both the vtam vary inact and cp force commands. 

If the logical unit is being terminated by vm, the vmblok status prevents the cp 
force command from being effective. The vmkill bit in the vmblok indicates 
whether cp is in the process of terminating the logical unit. If you issue the cp 
force command and the resource is unknown, cp may be waiting for an iucv 
reply before completing the termination process for the logical unit. Try using 
the vtam vary inact command. 

If the logical unit is still hung, continue with step 2. 

2. Determine which components are still connected to the logical unit. 

• Use the vscs command display id = luname to determine the status of the 
logical unit and of the send rpl. 

• Is the user still logged on to vm? 

• Does the logical unit name appear when you use the cp query names 
command? If so, the vm connection has not been severed. 

• Does vtam show the logical unit still in session with vscs? Use the vtam 
display command to determine this. 

From this information, try to determine which components are connected to the 
logical unit. 

3. Note the status of the logical unit at this time. For example, on a display 
screen, what is in the status area, and what was the last input or the last output 
to the logical unit? 

Note: If the user logged off and the screen says “holding,” you must clear the 
screen before the logical unit can be disconnected from vm. (This is normal for 
vscs.) 

4. Collect documentation. 

If you can re-create the problem, get: 

• vscs dump 

• vscs operator console listing 

• vtam buffer contents trace 

• vscs trace for the failing logical unit, running externally, with all options 
active (except fre and get, for vtam V3R2) 

• vtam internal trace with opt={api,msg,piu,pss,sscp), mode=ext. 

If you cannot re-create the problem, get: 

• vscs dump 

• vscs operator console listing 

• vscs CCS and dispatcher trace. 

5. Goto “Reporting Procedure” on page 68. 
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Q Logical Unit is Hung for Other Reasons 

1. Answer these questions. 

a. Issue the cp query names command on the cp console. Does the logical 
unit name appear? 

b. Is vscs still controlling the logical unit? (Use the vtam display command to 
discover this.) 

c. Have any messages appeared on the vtam or vscs operator console for this 
logical unit? 

d. What is the last sequence of messages issued? (See the vscs operator 
console listing.) 

e. Issue vscs display id =luname. Is the rpl busy? 

2. Collect documentation. 

If you can re-create the problem, get: 

• vscs dump 

• vscs operator console listing 

• vtam buffer contents trace 

• vscs traces for the failing logical unit, running externally, with all options 
active (except fre and get, for vtam V3R2). 

• vtam internal trace with opt=<api,msg,piu,pss,sscp), mode=ext. 

If you cannot re-create the problem, get: 

• vscs dump 

• vscs operator console listing 

• vscs ccs and dispatcher trace. 

3. Go to “Reporting Procedure" on page 68. 
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VM 


VSCS Operator Commands Do Not Complete 

1. Has the vscs Utility Services subtask abended? 

Check the operator console listing to see if the Utility Services subtask abnor¬ 
mally terminated. If this occurs vscs can do no further processing of operator 
commands. Use the vscs cancel command to terminate vscs. Then get the 
dump generated by the abend and go to “vm Termination Problems” on 
page 109. 

2. Does a gcs message indicate a problem with the gcs console task? If that task 
abended or could not get storage, operator commands cannot reach vscs. 

3. If the problem is not an abend or gcs console task, try these commands: 

• If vscs is running in the same virtual machine as vtam, enter a vtam 
command such as display lu. Does it complete? 

- If yes, vscs may be in a loop or a permanent wait. 

- If no, the problem is in the vtam virtual machine. Continue down this 
list to determine where the problem is. 

• Enter the cp query time command. This shows whether gcs is processing 
and passing cp commands to cp. 

• Enter #cp query names. This shows whether cp commands are being proc¬ 
essed. 

4. Does gcs process some commands, but not others? Does the pai key put the 
terminal in cp read mode? 

If the answer to both questions is yes, gcs is looping or waiting for an event to 
complete. In cp read mode, issue set run off. Then enter the cp command d 
psw to display the current psw. Display the storage around the address shown 
in the second half of the psw. If the last instruction issued was X' B2F0xxxx', cp 
has not completed an iucv request, and vscs and the virtual machine are per¬ 
manently waiting for a response. If the problem does not involve an iucv 
instruction, check to see if the wait bit (bit 14) is on in the psw. If so, the 
problem is in the vscs virtual machine. Get a vscs dump and go to “Reporting 
Procedure” on page 68. The vscs dump is described in “vm VSCS Dump” on 
page 155. 
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v M Message Problems 

For messages other than DTIS99I, go to “Message Procedure" on page 53. 


vm Message DTIS99I Indicates a VSCS Internal Error 

Message dtis99I tells you that a vscs internal error occurred for module dtixxxxx 
and a number (n). The number identifies the reason the message was issued. Use 
the lists below to determine which component of vscs issued the message. See the 
following example: 

DTIS99I INTERNAL VSCS ERROR - DTIPRSVR 1 

This indicates that vscs attempted to issue an iucv sever for the vscs global path. 
For this error, a dump is taken (if dumping is enabled) and the sever request is 
ignored. 

1. Presentation Services issues messages with this information: 


Module 

n 

Error Description 

DTIPDADV 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPICPY 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPIPUT 

1 

Error in logical aid 


2 

Invalid WEBLAID (logical aid) 

DTIPISYN 

1 

Invalid SEND/REPLY WEB type 

DTIPOCWR 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPOFWR 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPOVSR 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPOWIC 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPOWRT 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPRACT 

1 

Received an invalid WEB 

DTIPRSVR 

1 

Attempting to issue a SEVER for global path ID 

DTIPRWEB 

1 

Invalid WEB 

DTIPSCFS 

1 

Invalid FS response WEB 

DTIPSCPY 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPSFCR 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPSPIN 

1 

SEND-in-progress bit error (VTAM V3R1.2 and later) 

DTIPSTAM 

1 

Queue tag error for work element queue 


2 

Invalid WEBFUN or WEBMODE 


3 

Invalid WEBFUN or LBCSTATE 


Note: dtipiput will request a dump if you use the wrong logmode entry when 
logging on to vscs with a type 1 logical unit (twx, 2741, or 3767). The pservic 
field in the logmode entry you use must contain X'01' in byte one, or vscs 
assumes the terminal is a type 0 logical unit (display terminal), vscs requires a 
valid aid character to process input from a type 0 logical unit, and the type 1 
logical unit does not provide this. 
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2. vtam Services issues messages with this information: 


Module 

n 

Error Description 

DTIVCLSX 

1 

Schedule request to DTIVTRME failed 


2 

No storage available 

DTIVLOFF 

1 

IUCV connection exists 

DTIVPURG 

1 

Schedule failed 

DTI VR EC A 

1 

Error in building WEB 

DTIVRECX 

1 

Invalid input chain 

DTIVREJR 

1 

Logical unit not in termination 

DTIVSEND 

1 

Invalid request (VTAM V3R1.2 and later) 


2 

Invalid request (VTAM V3R1.2 and later) 


3 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 


4 

Schedule request failed (VTAM V3R1.2 and later) 

DTIVSNDX 

1 

Invalid RPL response 


2 

Dequeue error in recovery (VTAM V3R1.2 and later) 


3 

Invalid data response in recovery (VTAM V3R1.2 and later) 


4 

Invalid RPL response (VTAM V3R1.2 and later) 


5 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 


6 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 


7 

Attempting to schedule DTICMT (VTAM V3R1.2 and later) 

DTIVSTAM 

1 

Queue tag error for work element queue 


2 

Invalid WEBFUN or WEBMODE 


3 

Invalid WEBFUN or LBCSTATE 

DTIVTPNX 

1 

Cannot schedule request 


3. System Services issues messages with this information: 


Module 

n 

Error Description 

DTISCHED 

i 

Invalid process identifier 

DTISDEQU 

i 

Queue tag does not match tag in queue header 

DTISENQU 

i 

Invalid chain pointer 


2 

Queue tag does not match tag in queue header 

DTISFREB 

1 

Invalid SMP tag 


2 

Invalid request (releasing storage that is already free) 

DTISFREM 

1 

Invalid SMP tag 

DTISGETB 

1 

Control block error or request is too big to obtain 


2 

Invalid free block count 

DTISGMGR 

1 

PDBUSCNT (chain pointer) is invalid 


2 

Empty PDBSDB queue found 
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4. Documentation to collect for vscs internal error problems: 

• Issuer of the message: Presentation Services, vtam Services, or System 
Services 

• Reason the message was issued 

• vscs dump (produced automatically as a result of message DTissgi if dumps 
were enabled prior to the problem occurring) 

• vscs operator console listing 

• Any vscs traces that were active at the time of the error. 
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VM 


Incorrect Output Problems 

1. Describe the incorrect output. The following list shows some of the possible 
symptoms: 

• The size of display screen is incorrect. 

• The status area of the display screen does not work as expected. 

• Highlighting or color do not work as expected. 

• Invalid characters appear in the output, such as ebcdic. apl. text, or double¬ 
byte Kanji characters. (Invalid characters are any characters that are obvi¬ 
ously wrong or that you don’t expect.) 

• Input data is lost. 

• progxxxx occurs on sna 3270s. If this happens during full-screen mode, the 
contents of the data stream may be invalid. If the terminal is not in full¬ 
screen mode, this message is more likely to indicate a vscs problem or a 
logmode problem. 

• The device does not function like a VM-supported terminal and the problem 
is not due to a known restriction. 

• The incorrect output does not involve full-screen data or the vm/sp logo, 
and one or more of the following symptoms occur: 

- Data is misplaced on the screen. 

- Data is missing. 

- Content of data is incorrect. 

- Device errors occur or the logical unit is disconnected when you 
execute a command or a program. 

2. Check to see that product restrictions are not causing the incorrect output. 

3. Does the incorrect output involve the logo? See “vm VM/SP Logo Problems on 
an SNA Device” on page 113 for more information. 

Note: If you enter both the user id and the password on the user id line, you 
may receive a different dmk message than you would if you entered only the 
user id. 

4. Is the device defined correctly to vscs? 

Use the vscs command display id= luname to determine if the device is defined 
correctly to vscs. If the display command is not successful, get a dump of vscs. 
The logical unit control blocks in a dump also show the lu definition. 

If the lu definitions are not correct for the device, correct them and retest the 
logical unit. See VTAM Installation and Resource Definition for more informa¬ 
tion on defining logical units. 

5. Check to see if the appropriate vtam logmode for the device is being used. See 
VTAM Customization for more information on logmodes. 

6. Are user translation exits involved? 

If your system has user-written translation exits, try to re-create the problem 
without them. Use the dtigen parameters and see if the problem still occurs. 

7. Is Kanji support involved? 
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Double-byte character support for Kanji does limited editing. Check the data 
stream sent to see if it is within the limitations of double-byte support. 

Note: vscs does not check whether the device supports Kanji. The application 
has this responsibility. 

8. Are twx 3101 configuration switches set up as documented by vm? See the 
VM/SP Terminal Reference to find out how these switches should be set up. 

9. Other possible causes of incorrect output are listed here. You may choose to 
investigate these further. 

• Functional limitation due to the release of vm/sp used 

• Hardware problem 

• vscs problem 

• vm problem 

• vm application problem. 

10. If the problem has not been solved, collect the following documentation: 

• For status area problems, lost input, device errors, and disconnections: 

- vscs dispatcher trace of the failing logical unit. 

- vscs trace with ccs active, of the failing logical unit. 

- vscs vtam exit trace of the failing logical unit. 

- vtam buffer contents trace. 

• For all other incorrect output problems: 

- vtam buffer contents trace of the failing logical unit. 

- vscs trace with ccs active, of the failing logical unit. 

- If a vscs dump is necessary, limit the number of users on the system 
and use the vscs bfrfifo command before re-creating the problem. 
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Storage-Related Problems 

Storage problems in vscs can occur for several reasons; they may indicate a 
problem in vscs. For vtam V3R2, issue the vscs storage command whenever you 
suspect that storage is causing problems. 

1. Determine whether the virtual machine in which vscs resides in is large 
enough. Estimate this using NPP Storage Estimates. 

Note: If vscs resides in the same virtual machine as vtam, add the storage 
requirements for vtam. 

If the virtual machine is large enough for your environment, continue. Other¬ 
wise, correct the vscs virtual machine size. 

2. If you are using new vscs start parameters, evaluate changes made with dtigen 
parameters: 

• Trace table size 

• Increase in the number of printers 

• Receive buffer size 

• blkmult greater than one 

• vsamlm number increased 

• Transmit buffer sizes for both logical units and displays 

• receive specific option (vtam V3R1.2 and later) 

• Exception response option (vtam V3R1.2 and later). 

If vscs ran properly before these changes, review the size of the vscs virtual 
machine before reporting a problem. 

You can use the vscs storage command (vtam V3R2) to see: 

• Current number of vtam sessions and cp connections 

• Indicator of storage shortage in message dtisisi 

• Some of the dtigen options that are currently active 

• Storage management parameters for vtam V3R2 that have been specified 

• Number of veibs allocated (controlled by vsamlm). 

If vscs is running in the same virtual machine as vtam, use the vtam display 
bfruse command to determine vtam's storage usage. 

3. Is the network in slow-down or recovery mode? 

If the network is in slow-down mode, it will take additional storage to maintain 
data destined for the logical unit. This symptom could also be caused by one 
of the following: 

• vtam is recovering from a network failure. 

• vscs is in scip recovery after a network failure. 

• vscs is in a different virtual machine than vtam, and a dump is being taken 
for vscs or vtam 

• A vtam temporary storage shortage has occurred. 

• The i/o buffer has expanded for a vTAM-controlled device. 
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4. Are several logical units hung? 

The storage being used by hung logical units remains allocated until the 
logical unit is released or is terminated. If you are using the exception 
response mode and receive specific options, the amount of storage used could 
be enough to cause a storage shortage. See “vm General Procedures to Diag¬ 
nose Logical Unit Hang Problems" on page 94 before continuing. 

If you can re-create the problem, or if it is occurring frequently, gather the fol¬ 
lowing documentation: 

• vscs internal trace with options ccs, disp, fre, and get active 

• Dump of the vscs virtual machine. 

5. Did you receive message DTIS99I for dtisfreb or dtisgetb? 

This indicates that vscs is having a problem managing storage blocks. 

Note: As with other DTIS99I problems, dumps must be enabled prior to the error 
or you cannot get proper documentation. 

If you can re-create the problem, or if it is occurring frequently, gather the fol¬ 
lowing documentation: 

• vscs internal trace with the options ccs. disp. fre, and get active 

• Dump created when message DTIS99I is issued. 

Get a vscs dump and go to "Reporting Procedure” on page 68. 

6. Did you receive message dtisioi, followed by DTIV 121 ? 

This sequence of messages indicates that either the virtual machine is too 
small, or all available storage has been depleted. If the vscs virtual machine is 
large enough, the available storage may be allocated to a different vscs 
storage pool than the current storage requester. 

For example, if storage is available in the Presentation Services pool, but vtam 
Services needs it, then gcs cannot provide additional storage. Logons are 
rejected until Presentation Services releases the storage. 

In vtam V3R2, you can control the distribution of dynamic storage by coding the 
dtigen parameters that allow swapping of storage segments in one pool to a 
different pool, or returning them to gcs. The default for the dtigen storage 
options is to work as previous release of vscs. 

Get the following documentation: 

• vscs trace with ccs and disp active (and fre and get, for vtam V3R2), for all 
logical units, before the problem occurred (externally if possible). 

• vscs dump. 

Go to "Reporting Procedure” on page 68. 
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7. Is it an iucv pacing problem? 

iucv pacing is controlled by the value specified in the dtigen parameters (dpace 
for displays and kpace for keyboard/printers). 

For displays, the default value is the screen depth, which is also the default if 
the pace is set to 0. The screen depth varies by display type. 

For keyboard/printers, the default is 10. If the pace is set to 0 for 
keyboard/printers, there is no iucv pacing. 

For twx logical units, the default is 1, and cannot be changed in vscs. That can 
lead to increased iucv traffic, which can lead to a vscs storage shortage in a 
large network, or if vscs is running in a small virtual machine. 

If iucv pacing is not set properly, change the dtigen parameter and reinitialize 
vscs with the new dtigen. If the problem persists, get the following documenta¬ 
tion: 

• vscs trace with ccs active, started before the problem occurs 

• vscs dump. 

Go to “Reporting Procedure” on page 68. 

8. Other 

If the problem cannot be isolated from previous steps, then a dump of the vscs 
virtual machine is required. After obtaining the dump, use the vscs dump for¬ 
matter to print the vscs storage control blocks. If vscs is in the same virtual 
machine as vtam, then also evaluate the vtam storage. 

Get the output from the vscs formatter and the console log, and go to 
“Reporting Procedure” on page 68. 
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vm Performance Problems 

1. Do not use a large value for the dtigen parameter vsamlm. This can lead to 
excessive paging in a medium-to-large environment. See VTAM Customization 
for more information on vsamlm, and NPP Storage Estimates to see if the 
virtual machine size is correct. 

Note: If vscs is running in the same virtual machine as vtam, include the vtam 
storage size required when you determine the virtual machine size. 

If you think your performance problem is related to paging and storage, (for 
example, you are getting slow response time for operator commands or logical 
units,) collect this documentation: 

• vscs dump 

• dtigen parameters 

• gcs internal trace for getmain and freemain. 

2. If you think your performance problem is related to logical units, (for example, 
you are getting slow response time for i/o operations,) collect this documenta¬ 
tion: 

• vtam i/o trace 

• vtam buffer contents trace 

• vscs trace for the failing logical unit, running externally, with all options 
active (except fre and get, for vtam V3R2) 

• gcs internal trace for sio and i/o. 

3. If you do not know the cause of the performance problem, collect all of the doc¬ 
umentation in the two lists above, plus supply the values for maxbfru, unitsz, 
and iobuf. 

4. When you have collected the necessary documentation, go to "Reporting 
Procedure” on page 68. 
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vm Other VSCS Problems 

Miscellaneous topics are covered in this section: 

• “vm SNA Dial Problems" on this page 

• “vm Printer Sharing Problems" on page 146 

• “vm Operator Commands Are Rejected" on page 147. 


vm SNA Dial Problems 

sna dial keeps the logical unit in full-screen state from the time the dial is complete 
until the dial is dropped or reset. All of the information on the screen is supplied 
by the resource that was dialed. 

1. If the screen size changed after one of the following occurred, take the indi¬ 
cated action: 

a. A vtam logical unit dialed another virtual machine. 

Make sure the virtual machine you are dialing supports the features pro¬ 
vided by your logical unit. 

b. A vtam logical unit, dialing pvm, dialed another gcs group or host con¬ 
taining VTAM. 

When dialing pvm, the logical unit is defined as a logical address, which 
may prevent the real device characteristics from being known. If you are 
dialing another vtam machine, supply a logmode name that describes the 
type of terminal you are using. 

If the screen size is still incorrect, collect the following documentation: 

• vscs trace with ccs active 

• vscs dump 

• vtam buffer contents trace (in both hosts if connecting to another vtam 
machine). 

2. Is the logical unit hung? 

If you are using pvm, find out whether the resource you are attempting to dial is 
active. An inactive resource could result in a hung logical unit. If the resource 
is active and the logical unit is hung, the resource, pvm, vscs, cp, or gcs may be 
experiencing problems. Note whether other pvm users’ terminals are also 
hung. 

If you cannot determine the reason, get the following documentation: 

• vscs dump 

• vscs trace with ccs active (must be active before the hang occurs). 

In the vscs dump, find the logical unit control blocks and the last few trace 
entries for that specific logical unit. From this, answer the following questions: 

a. Is the plb lbcstate of the logical unit 20, 40 or 60? 

b. Is the send rpl busy, indicating vscs is waiting for a response? 

c. Did vscs respond to all outstanding requests? 
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If everything is specified correctly, then get the following documentation: 

• vscs dispatcher and vtam exit traces 

• vtam internal trace, opt=api 

• vscs dump. 

Go to “Reporting Procedure" on page 68. 

3. Is the i/o interrupt missing? 

If the situation is caused by missing i/o, run these traces externally on just the 
failing logical unit: 

• vscs ccs and vtam exit traces 

• vtam internal trace, opt=cio, mode=ext 

• cp sio siof, and i/o traces (See the CP Command Reference) 

• gcs sio and i/o traces (See the VM/SP Planning Guide and Reference). 

Go to “Reporting Procedure" on page 68. 
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vm Printer Sharing Problems 

1. Is vscs printer sharing failing? 

If you coded a dtigen macro with prtshr = n, then change to prtshr = y, reas¬ 
semble dtiuser, link dtiuser into the vscs loadlib, and reinitialize vscs with the 
correct dtiuser number. 

If you are using default parameters or you are using a dtiuser with prtshr = y 
coded, then get the following documentation; 

• vscs dispatcher and vtam exit traces 

• vscs dump. 

Goto “Reporting Procedure” on page 68. 

2. Does vtam simlogon fail after you use the vscs printer command? 

If the vtam simlogon fails, then make sure: 

• The printer name was spelled correctly 

• The resource is known and available to vtam (use vtam display command) 

• The vtam logmode for the printer logical unit is correct. 

3. Does ‘not available’ appear in the status area of the display? 

In order for vscs to access a vtam printer, either the vscs printer command or 
a vtam vary act command must be issued first. See VTAM Operation for more 
information on commands. 

If the proper command was not issued or the printer name was misspelled, 
issue the command again with the correct name. 

If the proper command was issued to identify the printer to vscs, get the fol¬ 
lowing documentation: 

• vscs dispatcher and vtam exit traces 

• vtam internal trace, opt = api 

• vtam buffer contents trace for the printer logical unit 

• vscs dump. 

Go to “Reporting Procedure” on page 68. 

4. Is vscs not releasing a printer when requested to? 

If the printer was allocated to vscs by using the vtam vary act,logon = vscs 
command, then a vtam vary inact command is the only way to release it. 

If the vtam simlogon was used (check the vscs operator console listing), then 
vscs will use the time value specified in the dtigen parameters, timerel is used 
to determine when the printer will be released. (See VTAM Installation and 
Resource Definition for more information on timerel.) 

If the correct value for timerel is specified and vscs was initialized with the 
proper dtiuser module, then get the following documentation: 

• vscs dispatcher and vtam exit traces 

• vscs dump 

• vtam internal trace, opt=api 
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• vtam buffer contents trace for the printer logical unit before the Release 
was requested. 

Go to “Reporting Procedure” on page 68. 

5. Other printer problems: 

For problems not described above, get the following documentation: 

• vscs dispatcher and vtam exit traces 

• vtam internal trace, opt = api 

• vscs dump. 

Go to “Reporting Procedure” on page 68. 

vm Operator Commands Are Rejected 

Does vscs reject a command that was entered correctly and issue an error 
message? You may have entered the command at an inappropriate time. For 
example, a vscs start command is rejected when vscs is already active. Try using 
some other commands to see if they work. 

Note: Avoid using vscs halt, cancel, or quit; they could cause further problems. 

If the problem is unique to one command, or to a certain sequence of commands, 
get the operator console listing and go to “Reporting Procedure” on page 68. 
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Chapter 6 • VM Using VSCS Service Aids 

The following tools can help you diagnose vscs problems: 

• Messages 

• Operator console listing 

• Operator commands: bfrfifo, query, display, force, and storage 

• vscs dump 

• vscs trace facility. 

These service aids, along with service aids for vtam, can help you isolate problems 
to a single component and identify problems within vscs. 


vm Message and Module Conventions 

For most messages, the module name appears as the first word in the message 
text. For example, in message dticoii below: 

DTICINIT VSCS IUCV INITIALIZATION IS IN PROGRESS 

dticinit is the module name. If the module name is not given in the message text, 
see the message-to-module cross-reference in VTAM Messages and Codes for the 
module name. 

All vscs message and module identifiers begin with dti. Module names are in the 
form DTicaaaa, where aaaa is the unique module identifier and c represents the 
issuing subcomponent, as follows: 

C Communication Services for Inter-User Communication Vehicle (iucv) 

F System Services 

I Initialization and Termination Services 

P Presentation Services 

In this subcomponent ( DTiPaaaa), the fifth letter is one of the following: 

D Device manager 
I Input manager 
O Output manager 
R Request services 
S State manager 
S System Services 
V vtam Services 

In this subcomponent, a module with the last character of x (DTivaaax) indi¬ 
cates a vtam exit routine. 

Message identifiers are in the form dti cnni, where c indicates the issuing compo¬ 
nent (as above), nn is the two-digit serial number, and / is the action indicator: 

A Action 
E Eventual action 
I Information. 
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For internal vscs errors, module dtimsge issues the following message: 

DTIS99I INTERNAL VSCS ERROR modname n 

where modname indicates the name of the module that issued the message, and n 
identifies the nth occurrence of dtimsge within the module. This number n can be 
used to identify the reason the message was issued. See “vm Message DTIS99I 
Indicates a VSCS Internal Error” on page 135 and VTAM Messages and Codes for 
more information. 


vm Operator Console Listing 

The operator console listing is a printout of the messages that appear at the vscs 
operator console. The listing contains everything that appears on the operator's 
console during the entire session. It can help you find out the sequence of events 
when a problem occurs. If vscs is running in the same virtual machine as vtam, the 
console listing includes vtam messages as well as vscs messages. 

To obtain a console listing, issue the cp command spool console start. If you are 
using a hardcopy terminal, such as a 3767, this is not necessary because all input 
and output already comes out on paper. For more information on this command, 
see the VM/SP CP Command Reference . 

Note: If the operator console is in conmode 3270, the cp spool console command 
produces no output. 


vm Operator Commands 

vm BFRFIFO Command 

bfrfifo affects the dequeueing and dispatching structure for storage. Generally, 
storage is used from the top in a last-in-first-out fashion (bfrlifo). This is the 
default. For diagnostic purposes, however, you can turn on bfrfifo. This first-in- 
first-out method of storage preserves the queue long enough for you to see the ele¬ 
ments that have just been processed. 

To start bfrfifo, use the vscs bfrfifo command or the dtigen macro. For more 
information, see VTAM Operation. 

Note: Using bfrfifo can seriously degrade system performance, especially in a 
large network. 
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vm DISPLAY Command 

The vscs command display id = luname shows the status of a logical unit. 
Figure 25 shows an example of the vscs display command. 


vscs display id=13e0 

R; 

DTIS60I DISPLAY COMMAND ACCEPTED 

DTIS61I LU NAME = L3EQ DEVICE TYPE = 3277 MODEL = 2 

DTIS62I LU TYPE = 0 DEVICE FEATURES = NEDS APL( OLD ) 

DTIS63I SCREEN SIZE = 24 BY 80 ALTERNATE SIZE = BY PACE = 24 

DTIS65I IUCV PATHIDS =23 CURRENT RPL COMMAND = SEND 

DTIS59I RECEIVE SPECIFIC RPL BUSY 

DTIS66I CURRENT STATES: PS = NMH VS = NORM ER 

DTIS67I LOGON TIME = 16 : 05 : 17 

DTIS68I SEND COUNT = 00000001 RECEIVE COUNT = 00000000 
DTIS77I VSCS COMMAND PROCESSING COMPLETE 

Figure 25. vm Example of the VSCS DISPLAY Command 


vm FORCE Command 

The vscs command force id = luname terminates the cp session and vtam session 
for a logical unit. This command may be used when the cp force and vtam vary 
inact commands do not terminate a logical unit. 

v i QUERY Command 

The vscs query command displays the following information: 

• The location of the vscs trace table (if it has been allocated) 

• The status of vscs traces 

• The status of a vscs dump 

• The status of buffer queues. 

Figure 26 shows an example of the vscs query command. 


vscs query 

R; 

DTIS74I TRACE TABLE STARTS AT 001C5020 , ENDS AT 002BF05F 

DTIS84I SELECTIVE TRACE ACTIVE FOR LOGICAL UNIT ELU3101 

DTIS84I SELECTIVE TRACE ACTIVE FOR LOGICAL UNIT LU1920 

DTIS87I SELECTIVE VTAM, DISPATCHER AND CCS TRACE ACTIVE FOR 2 LU(S), 30 

DTIS93I VSCS EXTERNAL TRACE IS ENABLED 

DTIS76I VSCS DUMP PROCESSING IS ENABLED 

DTIS78I BUFFER DEQUEUE IS IN NORMAL MODE(BFRLIFO) 

DTIS77I VSCS COMMAND PROCESSING COMPLETE 

Figure 26. vm Example of the VSCS QUERY Command 
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vm STORAGE Command (V3R2) 

The vscs storage command shows the status of vscs dynamic storage, and some 
dtigen options that are in effect. 

Figure 27 shows an example of the vscs storage command when both stchktm and 
streltm are zero. 

vscs storage 
R; 

DTIS15I DYNAMIC STORAGE UTILIZATION 

DTIS16I RCVBFRL - 00010C DPXMTL - 0006BC KPXMTL - 00010C 

DTIS17I RPLNUM - 08 VSAMLM - 000A VEIBS - 000003 

DTIS18I BLKMULT - 01 STCHKTM - 000000 STRELTM - 000000 

DTIS19I GETMAIN - 00000B FREEMAIN - 000000 SWAP - 000000 

DTIS20I VTAMSES - 000000 CPC0NNS - 000000 CPMAX - 000000 

DTIS77I VSCS COMMAND PROCESSING COMPLETE 

Figure 27. VM Example of the VSCS STORAGE Command, STCHKTM = 0 and STRELTM = 0 

Figure 28 shows an example of the vscs storage command when either stchktm or 
streltm is greater than zero. 

vscs storage 
Ready; 

DTIS15I DYNAMIC STORAGE UTILIZATION 

DTIS16I RCVBFRL - 00011C DPXMTL - 00079C KPXMTL - 00011C 

DTIS17I RPLNUM - 08 VSAMLM - 000A VEIBS - 000003 

DTIS181 BLKMULT - 08 STCHKTM - 000001 STRELTM - 00000A 

DTIS191 GETMAIN - 00000A FREEMAIN - 000000 SWAP - 000000 

DTIS20I VTAMSES - 000000 CPC0NNS - 000000 CPMAX - 000000 


DTIS21I 

POOL 

HIGHWATER/VTAMSES 

CURRENT 

AVAILABLE 

LIFO 

DTIS22I 

PS 

000004 / 000000 

000004 

000002 


DTIS22I 

VS 

000001 / 000000 

000G01 

000001 


DTIS22I 

VX 

000001 / 000000 

000001 

000000 



DTIS77I VSCS COMMAND PROCESSING COMPLETE 

Figure 28. VM Example of the VSCS STORAGE Command, STCHKTM > 0 or STRELTM > 0 
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VM VSCS Dump 

The vscs dump contains all of the storage for vscs. It also contains common, group 
control system (gcs), and vtam storage if they are in the same virtual machine as 
vscs. 

To enable the dump, use the vscs dmpenabl command or the dtigen macro. For 
more information, see VTAM Operation. With dumping enabled, vscs can create a 
dump as soon as an internal error occurs. This ensures that the proper data is 
recorded before recovery processing begins. If an abend occurs, vscs creates a 
dump automatically, whether dumping is enabled or not. Use the gcs gdump 
command to obtain a dump of the vscs virtual machine for problems that do not 
cause vscs to dump automatically. 

While the dump is being taken, all network activity temporarily stops in order to 
keep the contents of the dump intact. When the dump is requested, vscs issues a 
message containing the name of the module requesting the dump and a dump 
identifier number, vscs dumps are numbered to correlate to the console mes¬ 
sages. 

Use the link-edit listing to locate key modules or work areas in the dump. The 
addresses of csects dtiisdai and dtiisda 2 also appear in the trace table header 
record, as shown in Figure 31 on page 162. dtiisdai and dtiisda 2 contain the global 
control blocks, which can be identified in the dump by their unique identifiers. For 
more information on control block identifiers, see “ vmVSCS Storage and Control 
Block Identifiers” on page 659. 


vm Dump Formatting Routine 

vscs provides a dump formatter to format vscs control blocks and the vscs internal 
trace table in a dump. The routine runs as part of prtdump. 

1. Use the gcs gdump command to dump vscs storage. 

2. Use ipcs to process the reader file produced by the dump. 

3. Use prtdump to format the vscs control blocks and internal trace table. 

Note: Use the vscs query command to find the location of the vscs internal trace 
table, and record its address. That way, if you cannot find the proper control 
blocks, you can still use the table's address to find them via the dump formatter. 
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Five options allow you to choose what portion of the dump you want to format: 


1 

2 

3 

4 

5 

Trace table 

DTlPDBs 

DTITAB 

Trace table 

Module list 

DTIPRM 

DTISDBs 

DTIPIBs 



DTISAB 

SCB summary 

DTIPLB 



DTICGB 


DTICLB 



DTIPGB 


DTIVLB 



DTIVGB 


Send RPL 



DTIGTD 


DTIWEB 



DTISCB 


DTIVEIB 



DTIUGB 


DTICMT 



DTICIA 


DTIXMT 



DTICMDs 


Logical unit 



DTISWBs 


trace 



DTI PACT 
DTIDSBs 

VTAM work 

area 

Path table 

DTITABs 

DTIPIBs 

DTIPLBs 

DTICLBs 

DTIVLBs 

Send RPL 

SCB summary 


entries 




Formatting may terminate if the following conditions occur: 

• If vscs cannot find the control blocks in the dump. Early in initialization and 
late in termination, the appropriate pointers and exits may not exist. If vscs 
cannot find the control blocks, it issues a message asking you for the vscs 
trace table address. From this, it can locate the control blocks. 

• If validity checking shows that a control block has been overlaid with data. 

• If a page of storage that vscs needs is unavailable. 

If formatting fails, you may print the dump unformatted. 

Figure 29 on page 157 shows how to use the dump formatting routine. It is taken 
from an operator console listing. 
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prtdump prbOOOOl 

PROCESSING FILE 'PRB00001 DUMP' 

CSIIPR550R DO YOU WISH TO FORMAT VTAM CONTROL BLOCKS? REPLY YES OR NO 

y 

FORMAT VSCS CONTROL BLOCKS? (YES OR NO) 

y 

DTIFT04 - VSCS DUMP FORMATTING 
DTIFT05 - VSCS CONTROL BLOCKS LOCATED 
DTIFTOl - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

3 

ENTER LUNAME(l-8 CHARACTERS): 


vtam 

DTIFT03 - FORMATTING VTAM LU CONTROL BLOCKS 
DTIF204 - SEARCHING FOR LU.... 

DTIF205 - EXTRACTING LU TRACE ENTRIES... 

DTIF201 - LU NAME VTAM PROCESSED 
DTIFTOl - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

5 

DTIFT09 - SEARCHING FOR MODULE NAMES 
DTIFTIO - SORTING MODULE NAMES... 

DTIFTOl - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

Figure 29 (Part 1 of 2). VM Using the VSCS Dump Formatting Routine 
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ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

1 

DTIF101 - SHOULD THE VSCS INTERNAL TRACE TABLE BE FORMATTED? Y]N 
n 

DTIFT01 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

2 

DTIFTOl - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

3 

ENTER LUNAME(l-8 CHARACTERS): 
vtam 

DTIFT03 - FORMATTING VTAM LU CONTROL BLOCKS 
DTIF204 - SEARCHING FOR LU.... 

DTIF205 - EXTRACTING LU TRACE ENTRIES... 

DTIF201 - LU NAME VTAM PROCESSED 
DTIFTOl - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 

2. STORAGE CONTROL BLOCKS 

3. SPECIFIC LU CONTROL BLOCKS 

4. VSCS TRACE TABLE ONLY 

5. VSCS MODULE CROSS REFERENCE LISTING 

P. PRINT ENTIRE DUMP 

Q. EXIT 

ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 

q 

FORMAT VTAM CONTROL BLOCKS? (YES OR NO) 


n 

Figure 29 (Part 2 of 2). vm Using the VSCS Dump Formatting Routine 
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The general format of control blocks in a formatted dump is: 

Control block name and address 
Control block information 

Offset .data in dump format. *. .printable. .* 


vm VSCS Trace Facility 

The vscs trace facility offers the following trace options: 

• ccs (Console Communications Services) 

• Cleanup 

• Data (V3R2) 

• Dispatcher 

• FRE (V3R2) 

• GET (V3R2) 

• vtam exit. 

All of the traces except cleanup are started with operator commands. (For the ccs 

and vtam exit trace options, the default is active.) The cleanup trace starts auto¬ 
matically with any of the other traces. 

The following list shows when each kind of trace entry is created: 

ccs trace Creates one entry for each iucv request or response sent or 

received by vscs. 

Cleanup trace Creates one or two entries for each logical unit at logoff or dis¬ 
connect. This trace is activated automatically when one or 
more of the other traces is activated. It cannot run by itself. 

Data trace (V3R2) Creates one entry for logical unit-bound data (output), and one 
entry for ccs-bound logical unit data (input). 

Dispatcher trace Creates one entry each time dtipstam or dtivstam gives control 
to another module to process a work element block. This can 
occur more than once for a single work element block. 

fre trace (V3R2) Creates one entry for each request to free a block of storage. 

get trace (V3R2) Creates one entry for each request for a block of storage. 

vtam exit trace Creates one entry each time vtam gives control to a vscs vtam 

exit. 

Figure 30 on page 160 shows where each trace occurs. 


LY30-5601-1 €> Copyright IBM Corp. 1984, 1989 


Chapter 6. vm Using VSCS Service Aids 159 





"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


GET |—►FRE 




VTAM 

API 


Figure 30. VM The VSCS Traces 

vscs records the data in an internal table that wraps around when full. The size of 
the trace table is variable and is specified during vscs initialization. The default 
size is 1000 records of 32 bytes each. 

The external trace option prevents trace information from being overlaid when the 
internal table wraps. If mode = ext, vscs maintains both the internal trace table and 
the external trace table. This ensures that a dump taken for an unrecoverable 
error will contain the relevant data from the internal trace table. The external vscs 
trace entries are sent to cptrap. See "vm How to Run External VSCS Traces” on 
page 161 for information on obtaining the external trace output. 

Storage for the trace table is not allocated until the trace is activated and tracing 
begins. When the trace facility is turned off, storage for the trace table is pre¬ 
served and can be dumped by the operator using the cp dump command. The vscs 
query command gives the starting and ending address of the trace table. In addi¬ 
tion, the trace table can be found through a pointer at sabtrhdr in the dtisab. See 
“vm How to Run External VSCS Traces” on page 161 and VTAM Operation for 
information on starting the vscs traces. 


vm Trace Degradation 

Each trace option causes some system degradation, but it can be controlled to 
some extent. The cleanup and ccs traces cause the least system degradation. The 
vtam exit trace causes a little more; and the data, dispatcher, fre, and get traces 
cause the most. That is why ccs is the default. 

If one or very few logical units are experiencing a problem, and you are re-creating 
the problem to get documentation, run the traces on only one logical unit. This 
reduces the impact of the trace on system performance and reduces the frequency 
of the trace table wrapping. 
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vm How to Run External VSCS Traces 

To run the vscs traces externally, issue the following commands from the vscs 
console: 

CPTRAP 3D 

CPTRAP GROUPID gcsgroup 

CPTRAP START TO userid userid is the receiver of the spool file 

VSCS TRACEON (EXT ALL ext means run the trace externally, all means turn on 

the ccs, data, dispatcher, fre, get, and vtam exit trace 
options. 

VSCS TRACEON luname This is required only for selective tracing. 

vscs starts tracing to a spool file. When you have collected enough data and you 
want to stop tracing, issue the following commands from the vscs console: 

VSCS TRACEOFF (EXT ALL Turn off external tracing. 

VSCS TRACEON * Turn off selective tracing. This command is needed 

only if selective tracing was used above. 

VSCS TRACEON (CCS Activate the ccs trace option and use the internal trace 

table. It is recommended that you run with this 
minimum trace at all times. 

CPTRAP STOP 

cp spools a file to the reader of the user id specified in the cptrap start command. 
Use trapred to look at the output as follows: 

ACCESS 193 x The gcs formatting routines are on this disk, "x” is a 

user-specified file mode. 

TRAPRED fileno “fileno" is the reader file number (q rdr). (Make sure 

the reader file is not in hold status.) 

3D Read vtam and vscs records only. 

FORMAT Format the records. 

PRINTER 999999 Print the records. (There are other commands which 

allow you to view the cptrap file online. See the VM/SP 
System Programmer's Guide for vm R4, or the VM/SP 
Facility for System Programming for vm rs.) 

QUIT 

vm VSCS Trace Table 

A trace may be started for one logical unit, up to 32 specific logical units, or all 
logical units at any time. If a trace is running for all logical units and the traceon 
command is specified for a single logical unit, then the trace only records data for 
the logical unit specified. In the same manner, if you are tracing a specific logical 
unit and issue traceon all, the trace now records data for all logical units. 
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The vscs query command shows: 

• What traces are active 

• Which logical units are being traced (if selective tracing is used) 

• Which trace options are in effect 

• The location of the internal trace table (if it is allocated). 


vm Trace Table Header 

The vscs trace table contains a header record (dtithdr) followed by the trace 
records (dtitrec). Figure 31 shows the trace table header. 


00 

T 

R 

Number of entries 

04 

Zero 

08 

Current trace 

entry address 

OC 

First trace entry in table 

10 

Last trace entry in table 

14 

Storage address used to free table 

18 

Zero 

1C 

Zero 

20 


Address of 

DTIISDA1 

24 


Address of 

DTIISDA2 

28 

Address 

of first CSECT in load module 

2C 


Address of 

DTI PATCH 

30 


Address of 

DTIIPARM 

34 

Zero 

38 

Zero 

3C 

Zero 


Figure 31. VM VSCS Trace Header Format 


The header shows this information: 


Byte (hex) 

00-01 

02-03 

04-08 

08-0B 

0C-0F 

10-13 

14-17 

18 — IF 

20-23 

24-27 


Contents 

DTITHDR element header (TR) 

Number of entries in table 
Zero 

Pointer to current entry in table 
Pointer to first entry in table 
Pointer to last entry in table 

Address to be used in freeing the trace table storage 
Zero 

Address of DTIISDA1 
Address of DTIISDA2 
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VM 


28 - 2B Address of DTIISTRT 

2C-2F Address of DTIIPATCH 

30-33 Address of DTIIPARM 

34-3F Zero 

Examples of VSCS Trace Output 

There are three ways to look at the vscs trace table: 

• Online at the operator console 

• In dump output 

• Formatted with trapred. 

1. To view the trace table online, issue the vm display command from the vscs 
operator console. (For more information on this command, see the VM/SP CP 
Command Reference.) Figure 32 on page 164 shows an example of the 
output. (The trace record titles were added to identify the different trace entry 
types.) 

Note: You can also use trapred to view the output online. The output looks the 
same whether you use the vm display command or trapred. See the VM/SP 
System Programmer's Guide (for vm R4) or the VM/SP Facility for System Pro¬ 
gramming (for vm R5) for more information about trapred. 

2. Figure 33 on page 165 shows what the trace table looks like in dump output. 
(The trace record titles were added to identify the different trace entry types.) 

3. Figure 34 on page 166 shows an example of a vscs trace running externally 
and formatted with trapred. (The procedure for obtaining this output is 
described in “ vm How to Run External VSCS Traces” on page 161.) For more 
information on using trapred, see the VM/SP System Programmer's Guide. 

(for vm R4) or the VM/SP Facility for System Programming (for vm rs). 
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Storage 

Address 

Trace header 


15E020 

E3D97F58 

00000000 

0015E780 

0015E060 

*TR\.. 

....X... 

_* 

15EQ30 

0025CB40 

0015E008 

00000000 

00000000 

* 


★ 

15E04Q 

Q013A948 

001588F8 

0012E000 

0015C0D8 

* 

.8. 

• Q* 

15E050 

Q013A568 

00000000 

00000000 

00000000 

* 


* 


VSCS CCS 

data trace 

entries 





15E06Q 

C305C3E3 

00012000 

000A0000 

5CC3C3E2 

*CNCT.. 

.*CCS* 

15EQ7Q 

40404040 

01010000 

0000000A 

E5D44040 

★ 

.VM 

* 


VSCS CCS global trace entries 





15E08G 

00125028 

00000001 

C7D3C2D3 

D9Q10310 


..GLBLR. 

* 

15E090 

OCOOOOOO 

00110000 

00000000 

E2E240C5 

★ 

.ss 

E* 


VSCS VTAM 

1 exit trace entries 





15E0AQ 

E5D3D6C7 

00124028 

001241B8 

00001910 

*VL0G.. 


* 

15EQB0 

00008000 

00000000 

10000000 

oooooooo 

* 


* 

15EQC0 

E5D6D7D5 

00124028 

171241B8 

00000000 

*V0PN.. 


★ 

15EQD0 

10758000 

00000000 

10000000 

00070002 

* 


* 


VSCS dispatcher trace entries 





15E0EQ 

D7020704 

00124028 

00127028 

80000000 

*P. 


.. * 

15E0F0 

00000000 

00000010 

00000000 

E2C9D5E3 

*P. 

.SINT* 

15E100 

D7020000 

00124028 

401254E0 

81000080 

*P. 

. ..... 

.. * 

15E110 

0O0O1DO0 

00000010 

00000000 

D6E6D9E3 

*P. 

.OWRT* 

15E120 

E5031004 

00124028 

40250028 

81000080 

*V. 

. 

★ 

15E130 

00000000 

00000010 

00000000 

E2C5D5C4 

*v. 

.SEND* 


VSCS CCS 

LU trace entries 





15E220 

0011E2B0 

00020000 

10751054 

F2830009 

*..s... 

.2. 

* 

15E230 

01000001 

00020000 

00000000 

40040050 

* 


.&& 

15E240 

0011E310 

00020000 

10751054 

C3830002 

*..T... 

.C. 

* 

15E25Q 

OE0O00O0 

00040000 

00000000 

00040000 

★ 


* 


VSCS cleanup trace entries 





15E6C0 

07D9C2D2 

02124028 

00840000 

80000000 

*PRBK.. 


★ 

15E6D0 

00000000 

00000000 

10751054 

0025F188 

* 


1.* 


Figure 32. vm VSCS Trace Records Displayed at the Operator Console 
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*< 

03 

O 

i 

CD 

03 

O 


O 

o 

■O 


CD 


O 

o 


CO 

00 


CO 

00 

(O 


(O 

c 


< 

< 

CD 

O 

CD 


&> 

o 

CD 

33 

(D 

o 

o 

Cl 

C/3 


O 

c 

3 

"D 

o 

c 

■O 

c 


STORAGE 

ADDR 

Trace header 


15E020 

15E040 


E3D97E58 

00000000 

0015E780 

0015E060 

0025CB40 

0015E008 

00000000 

00000000 *TR“.. 

.X. . 

. 

* 

0013A948 

001588F8 

0012E000 

0015C0D8 

0013A568 

00000000 

00000000 

00000000 *. 

. .8. 

. .0. 

* 


15E060 


15E080 


15E0A0 

15E0C0 


VSCS CCS data entry 


C3D5C3E3 00012000 

000A0000 

5CC3C3E2 

40404040 

01010000 

0000000A 

E5D44040 

*CNCT.. 

.*CCS 

.VM * 

VSCS CCS global trace entry 









00125028 00000001 

C7D3C2D3 

D9010310 

OCOOOOOO 

00110000 

00000000 

E2E24CC5 


..GLBLR. 

.SS E* 

VSCS VTAM trace entries 

E5D3D6C7 00124028 

001241B8 

00001910 

00008000 

00000000 

10000000 

00000000 

*VL0G. . 


♦ 

E5D6D7D5 00124028 

171241B8 

00000000 

10758000 

00000000 

10000000 

00070002 

* VOPN. . 




O 

zr 

P 

■o 

CD 

03 


< 

2 

C 

00 

3 ' 

CO 


< 

CD 

O 

CD 

CD 

0 


O 

0 


> 


CL 

C/3 


o> 

01 


VSCS Dispatcher trace entries 


15E0E0 

15E100 

15E120 

D7020704 

D7020000 

E5031004 

00124028 

00124028 

00124028 

00127028 

401254E0 

4025D028 

80000000 

81000080 

81000080 

00000000 
00001000 
00000000 

00000010 

00000010 

00000010 

00000000 

00000000 

00000000 

E2C9D5E3 

D6E6D9E3 

E2C5D5C4 

*P. 

*P. 

♦V. 


.SINT* 

.OWRT * 

.SEND* 


VSCS CCS trace entries 










15E220 

0011E2B0 

00020000 

10751054 

F2830009 

01000001 

00020000 

00000000 

40040050 

+. .s. 

_2. 

.&* 

15E240 

0011E310 

00020000 

10751054 

C3830002 

0E000000 

00040000 

00000000 

00040000 

*. .T_ 

.C. 

* 

VSCS Cleanup trace entry 

15E6C0 

D7D9C2D2 

02124028 

00840000 

80000000 

00000000 

00000000 

10751054 

0025F188 

♦PRBK.. . 


.1 . * 
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3D OE VTAM VM/6CS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 9A1222FFE3ABCOOO 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 

VREC RTN CODE 00 TAB 179B40 RPLREQ 23 RPL 17627C RPLFDBK 0000 RPLSENS 0000 NAU 0100 

PS STATE 00 PLBSM 00 00 00 00 VS STATE 00 VLBSWAP 30 80 00 00 VLBLRCD 00 EXIT DATA 04 00 00 
3D OE VTAM VM/GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK * 9A1222FFE727C000 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 

PDISP LBCSTTUS 02 WEBFUN 04 WEBMODE 04 WEBVSRPS 7D TAB 179B40 WEB 17A9C8 PS STATE 00 PLBSM 00 00 98 00 PLBDFLG 02 
PLB- 0FLG1 00 NOM 00 00 EDIT 00 PLBIA 00 VS STATE 00 VLBSWAP 30 80 00 00 VLBLRCD 00 MODULE IKIN 
3D OE VTAM VM/GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 9A1222FFEBEF8000 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 

CCS WEB 17A9C8 PATHID 0003 0006 CID 0100 OOOA TYPE Y PS STATE 00 WEBCOUNT 0003 WEBFUN 04 WEBMODE 00 

WEB- CHAR 00 EDIT 00 FLAGS 00 04 LINE OOOA CURSR 0000 TABCH 00 WEBRSVSA 00 WEBDATA 172FB100 *....* 

Figure 34. vmVSCS Trace Records Formatted with TRAPRED 


vmVSCS CCS Trace Record Format 

When the CCS trace option is active, vscs traces all traffic to and from ccs. You can 
limit the ccs trace to a selected set of logical units when you start it. The ccs trace 
produces three types of record formats: 

Logical unit-related for traffic associated with logical units 

Global for traffic not associated with a logical unit 

Data for traffic associated with logical units or global traffic. 

vm Format for a CCS Trace Entry for a Logical Unit 


QQ 

B 1 0' 

DTIWEB ADDRESS 

04 


PATH 

IDs 


08 


VTAM 

CID 


oc i 

Flow ind. 

LBCSTATE 

WEBCOUNT 

10 

WEBFUN 

WEBMODE 

WEBCHAR 

WEBEDIT 

14 

WEBFLAGS 

WEBCPFLG 

WEBLINE 

18 

WEBCURSR 

WEBTABCH 

WEBRSVSA 

1C 

First four characters of data 


Displacement: 

00 Zero 

01 -03 Address of DTIWEB associated with this request or response 
04-07 Path ID from Communication Services local block (CLB) 

04-05 VSCS path ID 
06-07 CCS path ID 

08-0B VTAM communication identifier (CID), either OAF or DAF 
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OC Flow indicator Flow direction 

R (Receive) CCS = > VSCS (outbound) 

Y (Reply) VSCS = > CCS (inbound) 

1 (1-way send) VSCS = > CCS (inbound) 

2 (2-way send) VSCS = > CCS (inbound) 

T (Reject) VSCS = > CCS (inbound) 

C (Message complete) CCS = > VSCS (outbound) 

Note: In this book, whenever a flow is referred to as inbound or out¬ 
bound, you should take the Console Communications Services (CCS) 
as the reference point. That is, flows toward the CCS are inbound', 
flows away from the CCS are outbound. 

OD LBCSTATE from PLB (See “ vm LBCSTATE Values for PLBINxxx” on 
page 214.) 

1. LBCINT Internal mode if on (on = 1). If LBCINT is 

on, see “ vm LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

.11. LBCFSSMF Full-screen support mode flags 

.1. LBCFSAV Screen available 

.. l. LBCFSII Full-screen input inhibited: 

B‘00‘ CP (Console) mode 
B‘01’ Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10’ Virtual machine mode queue CP 
messages. 

B'11’ Virtual machine mode available 
for switch. 



...1 .... 

LBCCOPY Copy mode: on = 1 


.... 1 ... 

LBCNAL NALflag: on = 1 


.11. 

LBCHOLD Holding flag: on = B‘11' 


. 1 .. 

LBCM10 ‘More’10 flag: on = 1 


. 1 . 

LBCM50 ‘More’50 flag: on = 1 


. 1 

LBCCMSD Screen written with a CMS DIAGNOSIS: 

on = 1 



No more holding state 

OE-OF 

WEBCOUNT 

Length of actual data in WEBDATA 

10 

WEBFUN 

WEB function code. This is explained in “vm WEB Func¬ 
tion Codes" on page 215. 

11 

WEBMODE 

Mode: 

00 Console 

01 CMS 

02 Full-screen 

04 Internal 

12 

WEBCHAR 

Character set (set by CCS for Console and CMS modes) 

00 EBCDIC character set 

01 APL character set 

02 TEXT character set 

13 

WEBEDIT 

Editing characteristics 


1111 .... 

Zero 
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.... 1... 

wEbmiEko 

Highlight input display 

. l 9m 

wEBEDPTI 

Do not print or do not display 

.1. 

w£6noeko 

Do not redisplay input on next output line 

.1 

WEBEDCUP 

Convert to upper case 

WEB FLAGS 



11. 

WEBRSV1 

Zero 

*i«, .... 

w&bcCnmd 

Request for display in conmode 3270 

* *i» .... 

w£Ble6 

Lirhited edit diagnose 

* * *, 

wfefeANFSW 

Allow any full-screen write; first full¬ 



screen write after reset. 

.... i* . . 

WEBDIAL 

SNA dialed logical unit 

.i.. 

WE&NOMOR 

CMS ERASE WRITE NO ‘MORE’ 



requested 

.i. 

WfcBpfcMPT 

WEBDATA contains pre-logon prompt 

.i 

wEBPASPA 

Pass PA1 (FSSM) as data to application 

WEBCPFLG 

CCS status flags for VSCS 

WEBSAFLG 

VSC6 status flags 

1. 

wEbcp'Ncr 

N6 carriage return (hardcopy terminal) 

.1. 

wifiCPPRI 

Priority flag 

..1. 

WEBcpalm 

Ring the alarm 

..1. 

wIBSAHLD 

Holding 

...1 .... 

WfcBCPMbE 

CP-generated bit = 1 

...1 .... 

WEBSAMOR 

‘More’ VM-generated bit = 0 

.... 1... 

WEBoPHLW 

Highlight write requested 

.1.. 

wk'BcfrAsp 

Indicates CCS response 

.1.. 

wIbsarsp 

Indicates VSCS response 

.... ..1. 

wEBcPrtrtR 

CCS request, requires response 

.1. 

WEBSARRR 

VSCS request, requires response 

.1 

WEfiCPRNR 

CCS request, requires no response 

.1 

wEbsArnr 

VSCS request, requires no response 


16-17 

WEBLINE 

Lida dumber for CMS WEBCMWRT 

16 

WEBLAID 

Logical attention identifier 

17 

WEBNLLOS 

Number of lines left on screen 

18-19 

WEBCURSR 

Cursdf position may be a relative address or a buffer 
address 

1A 

WEBTABCH 

Tab (not DtltAB) character 

IB 

WEBRSVSA 

Reserved 


1 ... .... 

WEBCPRDS DTIWEB is a redisplay DTI WEB 


, 1 *. .... 

WEBNOVCK Do not validity check data 


..1 . 

WEBaTTNW Attention write (VSCS only) yes = 1 


...1 1 ... 

Zero 


. 1 .. 

witSCHDIR Change direction required 


. 1 . 

WEBMASKW Write inhibit mask 


. 1 

Zero 

1C — IF 

WEBDATA 

First four bytes of data field 
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Format for a Global PCS Trace Entry 

A global entry occurs if ccs receives a request for a path id that has been severed. 


00 

B 1 0' 

DTIWEB address 

04 

PATH IDs 

08 

G 

L 

B 

L 

OC 

Flow ind. 

LBCSTATE 

WEBCOUNT 

10 

WEBCAN 

WEBMODE 

WEBCHAR 

WEBEDIT 

14 

WEBFLAGS 

WEBCPFLG 

WEBLINE 

18 

WEBCURSR 

WEBTABCH 

WEBRSVSA 

1C 

First four characters of data 


Displacement: 


00 Zero 

01 -03 Address of DTIWEB associated with this request or response 
04-07 Path ID (from CLB) 

04-05 VSCS path ID 
06-07 CCS path ID 
08-0B Characters ‘GLBL’ 

0C Flow indicator 

R (Receive) 

Y (Reply) 

1 (1-way send) 

2 (2-way send) 

T (Reject) 

C (Message complete) 


Flow direction 

CCS = > VSCS 
VSCS = > CCS 
VSCS - > CCS 
VSCS = > CCS 
VSCS = > CCS 
CCS = > VSCS 


0D 

WEBCAN 

Number of control areas 

0E-0F 

WEBCOUNT 

Length of actual data in WEBDATA 

10 

WEBFUN 

WEB function code. This is explained in “ vm WEB Func¬ 
tion Codes" on page 215. 

11 

WEBMODE 

Mode: 



00 Console 

01 CMS 

02 Full-screen 

04 Internal 

12 

WEBCHAR 

Character set (set by CCS for Console and CMS modes) 

00 EBCDIC character set 

01 APL character set 

02 TEXT character set 

13 

WEBEDIT 

Editing characteristics 


ini .... 

Zero 


.... l... 

WEBHIEKO Highlight input display 


.i.. 

WEBEDPTI Do not print or do not display 


.i. 

WEBNOEKO Do not redisplay input on next output line 
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.1 

WEBEDCUP 

Convert to upper case 

14 

WEBFLAGS 




11. 

WEBRSV1 

Zero 


.1. 

WEBCONMD 

Request for display in conmode 3270 


..1 . 

WEBLED 

Limited edit diagnose 


...1 .... 

WEBANFSW 

Allow any full-screen write; first full¬ 
screen write after reset. 


_ 1... 

WEBDIAL 

SNA dialed logical unit 


. 1# * 

WEBNOMOR 

CMS ERASE WRITE NO ‘MORE’ 
requested 


. 1. 

WEBPRMPT 

WEBDATA contains pre-logon prompt 


. 1 

WEBPASPA 

PA1 (FSSM) pass as data to application 

15 

WEBCPFLG 

CCS status flags for VSCS 


1 . 

WEBCPNCR 

No carriage return (hardcopy terminal) 


.1. 

WEBCPPRI 

Priority flag 


..1 . 

WEBCPALM 

Ring the alarm 


..1 . 

WEBSAHLD 

Holding 


...1 .... 

WEBCPMDE 

CP-generated bit = 1 


...1 .... 

WEBSAMOR 

'More' VM-generated bit = 0 


.... 1... 

WEBCPHLW 

Highlight write requested 


.1.. 

WEBCPRSP 

Indicates CCS response 


.1.. 

WEBSARSP 

Indicates VSCS response 


.1. 

WEBCPRRR 

CCS request, requires response 


.1. 

WEBSARRR 

VSCS request, requires response 


. 1 

WEBCPRNR 

CCS request, requires no response 


.1 

WEBSARNR 

VSCS request, requires no response 

16-17 

WEBLINE 

Line number for CMS WEBCMWRT 

16 

WEBLAID 

Logical attention identifier 

17 

WEBNLLOS 

Number of lines left on screen 

18-19 

WEBCURSR 

Cursor position may be a relative address or a buffer 



address 


1A 

WEBTABCH 

Tab (not DTITAB) character 

IB 

WEBRSVSA 

Reserved 



1. 

WEBCPRDS 

DTIWEB is a redisplay DTIWEB 


.1. 

WEBNOVCK 

Do not validity check data 


..1 . 

WEBATTNW 

Attention write (VSCS only) yes = 1 


...1 1 ... 


Zero 


. 1 .. 

WEBCHDIR 

Change direction required 


. 1 . 

WEBMASKW 

Write inhibit mask 


. 1 


Zero 

1C— IF 

WEBDATA 

First four bytes of data field 
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vm Format for CCS Data Trace Entries 

0 4 IF 

// 


// 

Displacement: 

00-03 Header 

‘ACNT Accept connection 

‘CMSG 1 Completion of a 1-way send 

‘CNCT 1 Connect 

‘CXIT’ Invalid external interrupt 

‘GMSG’ Ignored traffic on global path 

LIER' Logical interface error 

‘SCNT Sever connection 

‘SEVR’ Sever 

04 - IF First 28 bytes of data from area passed 

ACNT Entry: Accept connection, ccs = > vscs 

0 4 8 C IF 

'ACNT' Module ID Zero IUCV parameter list 


Displacement: 

00 -03 Characters ‘ACNT’ 

04-07 Last four characters of module making trace entry. First four charac¬ 
ters are always DTIP. 


08-0B 

Zero 



0C-0D 

Path ID 



0E 

IPFLAGS1 




1 . 

IPALL 

Quiesce, resume, and sever all 


.1. 

IPQUSCE 

Connect in quiesce mode 


..1 . 

IPPRTY 

Priority message, reply required 


...1 .... 

IPNORPY 

One-way protocol 


.... 1 ... 

IPCPENTY 

Entry from CP 


. 1 .. 

IPFGMID 

Message ID specified 


. 1 . 

IPFGPID 

Path ID specified 


. 1 

IPFGMCL 

Message class specified 

OF 

IPTYPE 

External interrupt code 

10-11 

IPSMGLIM 

Message limit 


12-13 

Zero 



14-15 

IPAUDIT 

Audit trail as follows: 

14 

IPAUDIT1 

Audit trail byte 1 


1 . 

IPADRPLE 

Reply too long for buffer 


CCS = > VSCS 
CCS = > VSCS 
VSCS = > CCS 
CCS = > VSCS 
CCS = > vscs 
CCS = > vscs 
CCS = > vscs 
VSCS = > CCS 
or 

CCS = > vscs 
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•1. 

IPADSNPX 

Protection exception on send buffer 


..1 . 

IPADSNAX 

Address exception on send buffer 


...1 .... 

IPADANPX 

Protection exception on answer buffer 


.... 1 ... 

IPADANAX 

Address exception on answer buffer 


. 1 .. 

IPADRJCT 

Message was rejected 


.11 


Zero 

15 

IPAUDIT2 

Audit trail byte 2 


1 . 

IPADRCPX 

Protection exception on receive buffer 


.1. 

IPADRCAX 

Address exception on receive buffer 


..1 . 

IPADRPPX 

Protection exception on reply buffer 


...1 .... 

IPADRPAX 

Address exception on reply buffer 


.... 1 ... 

IPADSVRD 

Path was severed 


.Ill 


Zero 

16-17 

Zero 



18 — IB 

User data 



1C — IF 

First four bytes of logical unit name 


CMSG Entry: Completion of a one-way send, ccs = > vscs 
0 4 8 C IF 


'CMSG' 

Module ID 

Zero 

IUCV parameter list 


Displacement: 


00-03 

Characters ‘CMSG’ 


04-07 

Last four characters of module making trace entry. First four charac- 


ters are always DTIP. 


08-0B 

Zero 



0C-0D 

Path ID 



0E 

IPFLAGS1 




1 . 

IPALL 

Quiesce, resume, and sever all 


.1 . 

IPQUSCE 

Connect in quiesce mode 


..1 . 

IPPRTY 

Priority message, reply required 


...1 .... 

IPNORPY 

One-way protocol 


.... 1 ... 

IPCPENTY 

Entry from CP 


. 1 .. 

IPFGMID 

Message ID specified 


. 1 . 

IPFGPID 

Path ID specified 


. 1 

IPFGMCL 

Message class specified 

OF 

IPTYPE 

External interrupt code 

10-13 

IPMSGID 

Message ID 


14-17 

IPTRGCLS 

Target class 


14-15 

IPAUDIT 

Audit trail as follows: 

14 

IPAUDIT1 

Audit trail byte 1 


1 . 

IPADRPLE 

Reply too long for buffer 


.1 . 

IPADSNPX 

Protection exception on send buffer 


. .1 . 

IPADSNAX 

Address exception on send buffer 


...1 .... 

IPADANPX 

Protection exception on answer buffer 
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. 11 

15 IPAYDIT2 

.1 . 

..1 . 

...1 .... 
.... 1 ... 
.Ill 

16-17 

18-IB (PBFADR1 
1C — ID 

IE-IF IPBFLN1 


IPAQANAX Address exception on answer buffer 

IPAPRJCT Message was rejected 
Zero 

Audit trail byte 2 

IPADRCPX Protection exception on receive buffer 
IPApRCAX Address exception on receive buffer 
IPApRPPX Protection exception on reply buffer 
IPAPRPAX Address exception on reply buffer 
IPAPSVRD Path was severed 
Zero 

Zarp 

Address of buffer 1 
^erp 

Length of buffer 1 


CtyQT Entry: Request for connection, vscs = > ccs 
0 4 IF 


* CNCT' 


IUCV parameter list 


Displacement: 


00-03 

04-05 

06 


07 

08-09 

0A 

0B 

OC-13 
14 — IB 
1C— IF 


Characters ‘CNCT’ 


Path ID 



IPFLAQBI 



1 ... .... 

IPALL 

Quiesce, resume, and sever all 

.1 . 

IPQUSCE 

Connect in quiesce mode 

..1 . 

IPPRTY 

Priority message, reply required 

...1 .... 

IPNQRPY 

One-way protocol 

.... 1 ... 

IPCPENTY 

Entry from CP 

. 1 .. 

IPFGMID 

Message ID specified 

. 1 . 

IPFGPID 

Path ID specified 

.... ...1 

IPFQMCL 

Message class specified 

IPRCODE 

Return code 


IPSMQLIM 

Message limit 


IPFCNCD 

Function code 


Zero 



IPVMID 

•*CCS' 

Target virtual machine ID 


First four bytes of logical unit name 
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174 


CXIT Entry: Invalid external interrupt, ccs = > vscs 
0 4 1C 10 IF 




Error 


'CXIT' 

Bytes 0-23 of external parameter list 

Code 

VEIB 


Displacement: 


00-03 

Characters ‘CXIT’ 


04-05 

Path ID 



06 

IPFLAGS1 




1 . 

IPALL 

Quiesce, resume, and sever all 


.1 . 

IPQUSCE 

Connect in quiesce mode 


..1 . 

IPPRTY 

Priority message, reply required 


.,.1 .... 

IPNORPY 

One-way protocol 


.... 1 ... 

IPCPENTY 

Entry from CP 


. 1.. 

IPFGMID 

Message ID specified 


. 1. 

IPFGPID 

Path ID specified 


. 1 

IPFGMCL 

Message class specified 

07 

IPTYPE 

External interrupt code 

08-0B 

IPMSGID 

Message ID 


0C-0F 

IPTRGCLS 

Target class 


0C-0D 

IPAUDIT 

Audit trail as follows: 

OC 

IPAUDIT1 

Audit trail byte 1 


1 . 

IPADRPLE 

Reply too long for buffer 


.1. 

IPADSNPX 

Protection exception on send buffer 


••It •••• 

IPADSNAX 

Address exception on send buffer 


•••1 •••• 

IPADANPX 

Protection exception on answer buffer 


• X • • • 

IPADANAX 

Address exception on answer buffer 


• ••• 1 It 1 

IPADRJCT 

Message was rejected 


.11 


Zero 

0D 

IPAUDIT2 

Audit trail byte 2 


1. . . •••• 

IPADRCPX 

Protection exception on receive buffer 


« 1 t a •••• 

IPADRCAX 

Address exception on receive buffer 


• • 1 • •••• 

IPADRPPX 

Protection exception on reply buffer 


• ••1 tit* 

IPADRPAX 

Address exception on reply buffer 


• 1 • • • 

IPADSVRD 

Path was severed 


. Ill 


Zero 

0E-0F 


Zero 


10-13 

IPBFADR1 

Address of buffer 1 

14-15 


Zero 


16-17 

IPBFLN1 

Length of buffer 1 

18 — IB 

IPSRCCLS 

Source class 
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1C 


ID — IF 


DTICEXIT Error code point 

01 VSCS abnormally terminating 
02 Pending connect received - not supported 
03 Error dequeueing VEIB or no available VEIBs 
04 Error enqueueing VEIB on CGBCGMQ 
05 Error found - not specific 
06 Error enqueueing or dequeueing 
07 Scheduling with priority failed 

08 Scheduling failed 

09 No match found for path ID in VSCS path table 
0A Control block address passed does not point to a valid VSCS 
control block (SAB or TAB) 

0B Storage shortage obtaining additional VEIBs 
0C Storage shortage obtaining additional VEIBs 
VEIB Address 


GMSG Entry: Traffic on global path is ignored, ccs = > vscs 
04 1C IF 


'GMSG' 


Bytes 0-23 of external parameter list 


VEIB 


Displacement: 


00-03 

Characters ‘GMSG’ 


04-05 

Path ID 



06 

IPFLAGS1 




1 • • « • • » . 

IPALL 

Quiesce, resume, and sever all 


• 1». • ■ • • 

IPQUSCE 

Connect in quiesce mode 


* . 1 « . • . » 

IPPRTY 

Priority message, reply required 


...1 .... 

IPNORPY 

One-way protocol 


.... 1... 

IPCPENTY 

Entry from CP 


.1.. 

IPFGMID 

Message ID specified 


.1. 

IPFGPID 

Path ID specified 


.1 

IPFGMCL 

Message class specified 

07 

IPTYPE 

External interrupt code 

08-0B 

IPMSGID 

Message ID 


0C-0F 

IPTRGCLS 

Target class 


0C-0D 

IPAUDIT 

Audit trail as follows: 

OC 

IPAUDIT1 

Audit trail byte 1 


1. 

IPADRPLE 

Reply too long for buffer 


.1. 

IPADSNPX 

Protection exception on send buffer 


..1. 

IPADSNAX 

Address exception on send buffer 


...1_ 

IPADANPX 

Protection exception on answer buffer 


.... 1... 

IPADANAX 

Address exception on answer buffer 


.1.. 

IPADRJCT 

Message was rejected 


.11 


Zero 

0D 

IPAUDIT2 

Audit trail byte 2 


1 . 

IPADRCPX 

Protection exception on receive buffer 
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.1. 

IPADRCAX 

Address exception on receive buffer 


..1 . 

IPADRPPX 

Protection exception on reply buffer 


...1 .... 

IPADRPAX 

Address exception on reply buffer 


_ 1 ... 

IPADSVRD 

Path was severed 


.Ill 


Zero 

0E-0F 


Zero 


10-13 

IPBFADR1 

Address of buffer 1 

14-15 


Zero 


16-17 

IPBFLN1 

Length of buffer 1 

18 — IB 

IPSRCCLS 

Source class 


1C —IF 

VEIB Address 




LIER Entry: Logical interface error, ccs = > vscs 
0 4 8 10 14 18 IF 



Last four 

LU name 

OTITAB 

INPUT 


’LIER 1 

char of 
module 

with 

logic err 

ADDR 

DTIWEB 

ADDR 

'O' 


Displacement: 

00-03 Character‘LIER' 

04 - 07 Last four characters of module making trace entry. First four charac¬ 
ters are always DTIP. 

08-OF Logical unit name of device with logical interface error. 

10-13 Address of DTITAB 

14-17 Address of DTIWEB that was input to module making trace entry. 

18-IF Zero 


SCNT Entry: Request to sever connection, ccs = > vscs 
0 4 6 14 18 1C 10 IF 



Path 


Address 


Reason 


'SCNT' 

ID 

'O' 

Of TAB 
or SAB 

' 0 * 

Code 

*0' 


Displacement: 

00-03 Characters‘SCNT’ 

04-05 ID of path that was severed 
06-13 Zero 

14-17 Address of Terminal Anchor Block (TAB) or Service Application Block 
(SAB) 

18-IB Zero 
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1C Reason code 

1 VSCS not enabled by CP 

2 Maximum logical unit limit exceeded 

3 No VSCS global CONNECT accepted 

4 VTAM service machine (VSM) not enabled 

5 Duplicate logical unit name found on VSM RDEVBLOK chain 

6 This path ID is currently in use 

7 VTAM service machine was previously connected 

8 Message limit exceeded 

9 VTAM service machine global path severed 
ID — IF Zero 

SEVR Entry: Connection severed, vscs = > ccs or ccs to = > vscs 
046 14 18 IF 


'SEVR' 

Path 

'O' 

Address 
of TAB 

'0' 


ID 


or SAB 



Displacement: 

00-03 Characters 'SEVR' 

04-05 ID of path that was severed 
06—13 Zero 

14-17 Address of TAB or SAB 
18 — IF Zero 


vm VSCS Dispatcher Trace Record Format 

When the dispatcher trace option is active, vscs traces all traffic through the vscs 
state managers (dtipstam and dtivstam). This trace can be limited to one or 
several logical units by starting the vscs dispatcher trace for selected logical units. 
Use the vscs traceon (disp command to start the vscs dispatcher trace. See VTAM 
Operation for additional information. The dispatcher trace produces two types of 
record formats: 

Logical unit-related for traffic associated with logical units 
Global for traffic not associated with a logical unit. 

The following examples show the format of records created for each event. 
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vm Format for a Dispatcher Trace Entry for a Logical Unit 

00 Header LBCSTTUS i WEBFUN WEBMOD 
_ I _ 

04 WEBVSRPS DTITAB address 


08 PLBDFLG1 DTIWEB address 


oc 

LBCSTATE 

PLBFSSMF 

PLBLFLG1 

PLBFLG1 

10 

PLBPRLBC 

PLB0FLG1 

PLBN0M 

14 

PLBEDIT 

PLBIAFLG 

LBCSTATE 

VLBFLG 

18 

VLBFLG1 

VLBFLG2 

VLBSENDF 

VLBLRCD 


1C Last four characters of module name 


Displacement: 

00 Header ID 

D No module ID found or address of module is zero 
P Presentation Services dispatcher 
V VTAM Services dispatcher 
01 LBCSTTUS and current task running 

1. LBCSIP 1 = busy, 0 = not busy 



.111 1 ... 

Zero 


. 1 . 

Presentation Services task running 


.11 

VTAM Services task running 


. 1 .. 

Unknown task running 

02 

WEBFUN 

WEB function code from input WEB. This is explained in 
“ vm WEB Function Codes” on page 215. 

03 

WEBMODE 

WEB mode from input WEB 


00 Console 
01 CMS 
02 Full-screen 
04 Internal 


WEBVSRPS 

VTAM Services response to SEND request from Presen¬ 
tation Services 

01 

WEBVSOPC 

Operation check 

02 

WEBVSLFU 

Unconditional logoff 

03 

WEBVSERR 

Unrecoverable I/O error 

04 

WEBVSBSY 

Printer busy 

05 

WEBVSIRQ 

Intervention required 

06 

WEBVSNAV 

Printer not available 

07 

WEBTWXER 

TWX read error, sense code 0827 

08 

WEBVSAOK 

Successful completion 

OC 

WEBVSVER 

Unrecoverable internal error 

0D 

WEBVSPSL 

Presentation space integrity lost 

0E 

WEBVSCNL 

SEND canceled by cancel key 

OF 

WEBVSCC1 

Reflect attention, CC1 on SIO 

10 

WEBVSECU 

Equipment check and unit specify 
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11 WEBVSDCU Data check and unit specify 

12 WEBVSEC Equipment check 

13 WEBVSCRJ Command reject 

14 WEBVSDC Data check 

15 WEBVSCC Command check 

05-07 DTITAB Address of TAB passed 

08 PLBDFLG1 Device manager flags 


1. 

PLBDASS 

Display has alternate size 

.1. 

PLBDNEW 

Bit is on for a 3278, bit is off for a 3277 

..1. 

PLBNOVCK 

Do not validity check data 

...1 11.. 

PLBDCH 

Display has new color or highlight func¬ 
tions, no B‘000’ 

...1 .... 

PLBDXTDS 

Extended data stream available 

.... 1... 

PLBDXCLR 

Extended color available 

.1.. 

PLBDXHLI 

Extended highlight available 

.1. 

PLBDATTN 

Printer attention 

.1 

PLBDMASK 

Password mask 

DTIWEB 

Address of current WEB 


0C LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 
page 214.) 

1. LBCINT Internal mode if on (on = 1). If LBCINT is 

on, see “vm LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

.11. LBCFSSMF Full-screen support mode flags 

.1. LBCFSAV Screen available 

. .1. L6C£SII Full-screen input inhibited: 

B'00’ CP (Console) mode 
B‘0T Virtual machine mode state 
between ATTN and READ, 

QUEUE CP messages. 

B‘10’ Virtual machine mode QUEUE CP 
messages. 

B‘11’ Virtual machine mode available 
for switch. 

...1 _ LBCCOPY Copy mode: on = 1 

.... l... LBCNAL NALflag: on = 1 

.11. LBCHOLD Holding flag: on = B'11’ 

.1.. LBCM10 ‘More’ 10 flag: on = 1 

.1. LBCM50 ‘More’50 flag: on = 1 

.1 LBCCMSD Screen written with a CMS DIAGNOSE: 

on = 1 

. No more holding state 

0D PLBFSSMF Full-screen support mode flags 

1. PLBFPA1 PA1 key received switch mode 

. 1. PLBFSRFC Mode switch required (FSSM to Console) 

.. 1. PLBFSAFC Switch available (FSSM to Console) 

...1 _ PLBFCNMP Console message pending 

_ 1... PLBFVSIP VTAM Services SEND in progress 
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.1.. PLBFCLGF Conditional logoff received 

.1. PLBFCMRR CP message pending, response required 

.1 PLBCMSEW Screen has just been erased 

OE PLBLFLG1 VTAM Services logoff flags for Presentation Services 

1. PLBLVS VTAM Services logoff received, bypass 

logo 

, 1. PLBLGFC WEBINLGF sent to CCS conditional logoff 

.. 1. PLBLGFU WEBINLGF sent to CCS unconditional 

logoff 

...1 .... PLBLERR WEBINERR sent to CCS for hard error 

.... 1... PLBLLERR WEBINLER sent to CCS for interface 

error 

.1.. PLBLVERR WEBINVER sent to CCS for internal logic 

error 

.1. PLBLSEVR CP CCS SEVER received, must sever 

.1 PLBLNSTR No storage indicator in logoff 

OF PLBFLG1 PLB flags 

1. PLBLGO Logo mode logical unit 

.1. PLBINAR APL/TEXT starting in input area 

., 1. PLBLFLNP Logon from logo not permitted 

... 1 .... PLBCONCT Current count incremented 

.... 1... PLBCNCTI IUCV CONNECT issued 

.1.. PLBINREC Input received during purge processing 

.1. PLBPRMPT Usability prompt message flag 

.1 PLBSDIAL SNA-dialed logical unit 

10 PLBPRLBC Previous logical unit LBCSTATE 

11 PLBOFLG1 Output manager flags 

1. PLBSDIAG CMS DIAGNOSE on screen 

.1. PLBPSMSG Priority message on screen 

..1. PLBOSRIP SEND retry in progress 

... 1 .... PLBOKLOK Keyboard locked 

.... 1... PLBOKPMI Keyboard printer mask input area sent 

. 1 ., PLBOSWRT CMS WRITE active (no input received) 

. 1 . PLBOCRRQ Carriage return required before SEND on 

hardcopy terminal 

.1 PLBOEXRQ '!’ required before SEND on hardcopy ter¬ 
minal 

12-13 PLBNOM Notify output manager 

12 PLBNFLG1 NOM flag 1 

1. PLBCEND Command end (read) 

.1. PLBRDTX The redisplay timer has expired 

.. 1. PLBSAC Status area change required 

...1 .... PLBCLROA Clear output area 

_ 1 ... PLBCLRIA Clear input area 

.1.. PLBRING Ring the alarm 

.1. Zero 

.1 PLBUNLK Unlock keyboard 

13 PLBNFLG2 NOM flag 2 
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PLBRDPND 

Redisplay pending 


.111 1111 


Zero 

14 

PLBEDIT 

Editing flags 



1 . 

PLBNCONV 

User-translated output data 


.111 .... 


Zero 


_ 1... 

PLBHIEKO 

Highlight input redisplay 


.1.. 

PLBEDPTI 

Do not print or do not display 


.1. 

PLBNOEKO 

Do not redisplay input on next output line 


.1 

PLBEDCUP 

Convert to upper case 

15 

PLBIATTN 

Input manager attention handling 

15 

PLBIAFLG 

Input manager attention handling flags 


1. 

PLBMATTN 

Multiple attention received 


.1. 

PLBSATTN 

Single attention received 


..1. 

PLBIPA1 

Attention received in ’MORE’ 


...i mi 


Zero 

16 

LBCSTATE 

VLB 



. 1 

LBCVSST 

VTAM Services state: 0 = Normal, 

1 = Termination 

17 

VLBFLG 

VLB flags 



1. 

VLBBSPBB 

Bracket-state pending begin bracket 


.1. 

VLBBSPEB 

Bracket-state pending end bracket 


..1. 

VLBBSINB 

Bracket-state in bracket 



VLBSR 

Application SEND or RECEIVE state: 

1 = SEND state, 0 = RECEIVE state 


.... mi 


Zero 

18 

VLBFLG1 

VLB flag 1 



1. 

VLBIOTR 

Inbound data received since last SEND 


.1. 

VLBCLSD 

CLSDST not required 


..1. 

VLBPCS 

Purging chain state 


...1 .... 

VLBSIGNL 

Signal sent 


.... 1... 

VLBCHGD 

Change direction required 


. 1.. 

VLBRETR 

Retry RECEIVE request 


.... ..1. 

VLBRETS 

Retry SEND request 


.... ...1 


Zero 

19 

VLBFLG2 

VLB flag 2 



1 ... .... 

VLBRPLB 

RPL in use 


.1 . 

VLBCLPND 

VTAM CLSDST pending 


..11 .... 


Zero 


.... 1 ... 

VLBBUSY 

Printer busy 


.... .1.. 

VLBNAV 

Printer not available 


. 1 . 

VLBOPCK 

Operation check occurred 


. 1 

VLBWAIT 

Waiting for data or LUSTAT 

1A 

VLBSENDF 

Special SEND indicator 


1 ... .... 

VLBCLR 

Clear required 


. 1 *. .... 

VLBSDT 

Start data traffic (SDT) required 


.. 1 . .... 

VLBCANC 

Cancel required 


...i .... 

VLBSIGRQ 

Signal required 
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mi 


Zero 


IB 


1C — 1F 


VLBLRCD 

Logoff reason codes 

1 . 

VLBVTLO 

VTAM LOGOFF 

.1. 

VLBVRYI 

VARY INACTIVE 

..1 . 

VLBHLTQ 

HALT QUICK 

...1 .... 

VLBHLTC 

HALT CANCEL 

.... 1 ... 

VLBIOE 

Unrecoverable I/O error 

. 1 .. 

VLBINERR 

Internal error 

.11 


Zero 


Last four characters of module ID 


vm Format for a Dispatcher Trace Entry for a Global Connection 


00 

Header ID 

Task/Busy 

SABIQECB 

04 

Address passed 

08 

DTIWEB address 

OC 

SABFLG1 

SABABIPF 

SABLFLG1 

SABRFLG1 

10 

WEBFUN 

WEBMODE 

WEBCHAR 

WEBEDIT 

14 

WEBFLAGS 

WEBCPFLG 

WEBLINE 

18 

WEBCURSR 

WEBTABCH 

WEBRSVSA 

1C 

Last four characters of module name 


Displacement: 

0 Trace record header ID 

D No module ID found or module address is zero 
P Presentation Services dispatcher 
V VTAM Services dispatcher 


1 

LBCSTTUS and current task running 


...1 .... 

Address of SAB included 


.111 1 ... 

Zero 


. 1 . 

Presentation Services task running 


.11 

VTAM Services task running 


. 1 .. 

Unknown task running 

02-03 

SABIQECB 

First two bytes of SABIQECB event control block (ECB) 

04-07 


Address passed 

08-0B 

DTIWEB 

Address of WEB 

OC 

SABFLGS1 



1 . 

SABDMPNO Do not take a dump 


.1. 

SABVSCSV VSCS running in VTAM machine 


..1 . 

SABDUIP Dump in progress 


...1 .... 

SABCSOPN VSIUCV open 
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.... 1... 

SABBUFDQ 

DTISGETB dequeue type: FIFO = 1, 
LIFO=0 


.1.. 

SABGETFL 

GETMAIN failed 


.11 


Zero 


.1. 

SABNEWLG 

New logo format allowed 


.1 

SABVEIBS 

VEIB shortage has occurred 


.11 


Zero 

OD 

SABABIPF 

Abend-in-progress flags 


1. 

SABVABIP 

VTAM Services abend in progress 


.1. 

SABPABIP 

Presentation Services abend in progress 


..1. 

SABUABIP 

Utility Services abend in progress 


...i mi 


Zero 

OE 

SABTFLG1 

Global termination flags 


1. 

SABTETPE 

TPEND in progress 


.1. 

SABTESIQ 

Termination scheduled by DTIIQUIT 


..1. 

SABTETIP 

Termination in progress 


...1 .... 

SABTEATP 

Abnormal termination in progress 


_1... 

SABINVQT 

Invalid termination request detected 


.... mi 


Zero 

OF 

SABRFLG1 

Global recovery flags 


1. 

SABVSCTL 

VTAM Services task in control 


.1. 

SABPSCTL 

Presentation Services task in control 


..1. 

SABTICTL 

Timer exit in control 


...1_ 

SABCXCTL 

Communications Services exit in control 


.... ini 


Zero 

10 

WEBFUN 

WEB function code. This is explained in “vm WEB Func- 



tion Codes” 

on page 215. 

11 

WEBMODE 

Mode: 




00 Console 
01 CMS 




02 Full-screen 



04 Internal 


12 

WEBCHAR 

Character set (set by CCS for Console and CMS modes) 

00 EBCDIC character set 

01 APL character set 

02 TEXT character set 

13 

WEBEDIT 

Editing characteristics 


ini .... 


Zero 


.... l... 

WEBHIEKO 

Highlight input display 


.i.. 

WEBEDPTI 

Do not print or do not display 


.i. 

WEBNOEKO 

Do not redisplay input on next output line 


.i 

WEBEDCUP 

Convert to upper case 

14 

WEBFLAGS 




11. 

WEBRSV1 

Zero 


.1. 

WEBCONMD 

Request for display in conmode 3270 


..1 . 

WEBLED 

Limited edit diagnose 


...1 .... 

WEBANFSW 

Allow any full-screen write; first full¬ 
screen write after reset. 
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.... 1... 

WEBDIAL 

SNA-dialed logical unit 


.1.. 

WEBNOMOR 

CMS ERASE or WRITE NO ‘MORE’ 
requested 


.1. 

WEBPRMPT 

WEBDATA contains pre-logon message 


.1 

WEBPASPA 

Pass PA1 (FSSM) as data to application 

15 

WEBCPFLG 

CCS status flags for VSCS 


1. 

WEBCPNCR 

Do not imbed carriage return in data 
stream (on hardcopy terminal) 


.1. 

WEBCPPRI 

Priority flag 


..1. 

WEBCPALM 

Ring the alarm 


..1. 

WEBSAHLD 

Holding 


...1 .... 

WEBCPMDE 

CP-generated bit = 1 


...1 .... 

WEBSAMOR 

'More 1 VM-generated bit = 0 


.... 1... 

WEBCPHLW 

Highlight write requested 


.1.. 

WEBCPRSP 

Indicates CCS response 


.1.. 

WEBSARSP 

Indicates VSCS response 


.1. 

WEBCPRRR 

CCS request, requires response 


.1. 

WEBSARRR 

VSCS request, requires response 


.1 

WEBCPRNR 

CCS request, requires no response 


.1 

WEBSARNR 

VSCS request, requires no response 

16-17 

WEBLINE 

Line number for CMS WEBCMWRT 

16 

WEBLAID 

Logical attention identifier 

17 

WEBNLLOS 

Number of lines left on screen 

18-19 

WEBCURSR 

Cursor position may be a relative address or a buffer 



address 


1A 

WEBTABCH 

Tab (not DTITAB) character 

IB 

WEBRSVSA 

Reserved for VSCS use 


1. 

WEBCPRDS 

DTIWEB is a redisplay DTIWEB 


.1. 

WEBNOVCK 

Do not validity check data 


..1. 

WEBATTNW 

Attention write (VSCS only) yes = 1 


...1 1... 


Zero 


.1.. 

WEBCHDIR 

Change direction required 


.1. 

WEBMASKW 

Write inhibit mask 


.1 


Zero 

1C — 1F 

Last four characters of module ID (or entry address) 

vm VSCS VTAM Exit Trace Record Formats 


If you are 

running the default vscs trace (vscs V3R1.2 and later) and you have acti- 

vated the trace with an operator command, or by starting vscs with the vtam exit 
trace active, vscs traces all inbound traffic through the vscs vtam exits. You can 
limit the vtam exit trace to a selected set of logical units by starting vscs vtam trace 

for those logical units. 



You can produce the vtam exit trace in two formats: 

Normal trace record if the request is a valid vscs logical unit 

Data trace record if the request or response was invalid, or if the data traced is 
different from the normal vtam exit trace record. 
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Below is the format for the records created for each event. 


vm VSCS VTAM Exit Trace Entries 

OTIVCLSX 
DTIVDFAX 
DTIVLOGX 
DTIVNSEX 
DTIVOPNX 
DTIVRECX 
DTIVRESX 
DTIVRLQX 
DTIVSCIX 
DTIVSNDX 



Displacement: 

00 V = VTAM Services 

01 -03 Three-character module ID DTIVxxxx 

04 Return code from module 

05-07 TAB address for current request 

08 RPL request code 

09-0B RPL address 

0C-0D RPLFDB2 

0E-0F RPLUSNSI (user sense) or RPLSSNSI (system sense) 

10-11 Source network address 

12 LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 

page 214.) 

1. LBCINT Internal mode if on (on=1). If LBCINT is 

on, see “vm LBCSTATE Values for 
PLBINxxx" on page 214. If LBCINT is off, 
the following values apply: 

.11. LBCFSSMF Full-screen support mode flags 

.1. LBCFSAV Screen available 

..1. LBCFSII Full-screen input inhibited: 

B'00’ CP (Console) MODE 
B'OT Virtual machine mode state 
between ATTN and READ, 

QUEUE CP messages. 

B‘ 10’ Virtual machine mode QUEUE CP 
messages. 

B‘1T Virtual machine mode available 
for switch. 

...1_ LBCCOPY Copy mode: on = 1 

.... 1... LBCNAL NALflag: on = 1 

.11. LBCHOLD Holding flag: on = B'1T 

.1.. LBCM10 ‘More’10 flag: on = 1 

.1. LBCM50 ‘More’50 flag: on = 1 
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.1 LBCCMSD Screen written with a CMS DIAGNOSE: 

ON = 1 

. No more holding state 

13 PLBFSSMF Full-screen support mode flags 

1... PLBFPA1 PA1 key received switch mode 

.1. PLBFSRFC Mode switch required (FSSM to Console) 

.. 1. PLBFSAFC Switch available (FSSM to Console) 

...1 .... PLBFCNMP Console message pending 

.... 1... PLBFVSIP VTAM Services SEND in progress 

.... . 1.. PLBFCLGF Conditional logoff received 

.1. PLBFCMRR CP message pending, response required 

.1 PLBCMSEW Screen just cleared 

14 PLBLFLG1 VTAM Services logoff flags for Presentation Services 

1. PLBLVS VTAM Services logoff received, bypass 

logo 

.1. PLBLGFC WEBINLGF sent to CCS conditional logoff 

.. 1. PLBLGFU WEBINLGF sent to CCS unconditional 

logoff 

...1 .... PLBLERR WEBINERR sent to CCS for hard error 


• •It 

1 ... 

PLBLLERR 

WEBINLER sent to CCS for interface 

error 

• « • • 

. 1 .. 

PLBLVERR 

WEBINVER sent to CCS for internal logic 
error 

« • • • 

.. 1 . 

PLBLSEVR 

CP CCS SEVER received, must sever 

• • • • 

...1 

PLBLNSTR 

No storage indicator in logoff 

PLBNFLG1 

NOM flag 1 


1 ... 

• • • • 

PLBCEND 

Command end (read) 

. 1 .. 

• « • • 

PLBRDTX 

The redisplay timer has expired 

.. 1 . 

• • I • 

PLBSAC 

Status area change required 

...1 

# ' B « 

PLBCLROA 

Clear output area 

• • • • 

1 ... 

PLBCLRIA 

Clear input area 

• • • • 

. 1 .. 

PLBRING 

Ring the alarm 

• • • • 

.. 1 . 


Zero 

• • • • 

...1 

PLBUNLK 

Unlock keyboard 

PLBOFLG1 

Output manager flags 

1 ... 

.... 

PLBSDIAG 

CMS DIAGNOSE on screen 

. 1 .. 

• • • • 

PLBPSMSG 

Priority message on screen 

.. 1 . 

• • • • 

PLBOSRIP 

SEND retry in progress 

...1 

.... 

PLBOKLOK 

Keyboard locked 

« « * , 

1 ... 

PLBOKPMI 

Keyboard printer mask input area sent 

• • • • 

. 1 .. 

PLBOSWRT 

CMS WRITE active (no input received) 

• • • • 

.. 1 . 

PLBOCRRQ 

Carriage return required before SEND 
(on hardcopy terminal) 

.... 

...1 

PLBOEXRQ 

'!’ required before SEND (on hardcopy 
terminal) 

LBCSTATE 

From VLB 


.... 

...1 

LBCVSST 

VTAM Services state: 0 = Normal, 

1 = Termination 
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18 

VLBFLG 

VLB flags 



1. 

VLBBSPBB 

Bracket state-pending begin bracket 


.1. 

VLBBSPEB 

Bracket state-pending end bracket 


..1. 

VLBBSINB 

Bracket state-in bracket 


...1 .... 

VLBSFt 

Application SEND or RECEIVE state: 

1 = SEND state, 0 = RECEIVE state 


.... ini 


Zero 

19 

VLBFLG1 

VLB flag 1 



1 . 

VLBIOTR 

Inbound data received since last SEND 
indicator 


1 . 

VLBCLSD 

CLSDST: 0 = required, 1 = not 
required 


..1 . 

VLBPCS 

Purging chain state 


...1 .... 

VLBSIGNL 

Signal sent 


.... 1... 

VLBCHGD 

Change direction required 


. 1.. 

VLBRETR 

Retry RECEIVE request 


. 1. 

VLBRETS 

Retry SEND request 


.1 


Zero 

1A 

VLBFLG2 

VLB flag 2 



1 . 

VLBRPLB 

RPL in use 


.1. 

VLBCLPND 

VTAM CLSDST pending 


..11 .... 


Zero 


.... 1... 

VLBBUSY 

Printer busy 


. 1.. 

VLBNAV 

Printer not available 


.1. 

VLBOPCK 

Operation check occurred 


.1 

VLBWAIT 

Waiting for data or LUSTAT 

IB 

VLBSENDF 

Special function flags 


1. 

VLBCLR 

Clear required 


.1. 

VLBSDT 

SDT required 


..1. 

VLBCANC 

Cancel required 


...1 .... 

VLBSIGRQ 

Signal required 


.... mi 


Zero 

1C 

VLBLRCD 

Logoff reason 

codes 


1. 

VLBVTLO 

VTAM LOGOFF 


.1. 

VLBVRYI 

VARY INACTIVE 


..1 . 

VLBHLTQ 

HALT QUICK 


...1 .... 

VLBHLTC 

HALT CANCEL 


.... 1 ... 

VLBIOE 

Unrecoverable I/O error 


. 1 .. 

VLBINERR 

Internal error 


. 11 


Zero 


1D — 1F VTAM exit-module-dependent data 
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vm VTAM Exit-Module-Dependent Data 

DTIVCLSX 

1-3 WEB address or zero 

DTIVDFAX 

1 WEBFUN value. This is explained in “vm WEB Function Codes” on 
page 215. 

2 Zero 

3 Module flow indicator 

1. DTIVPURG called 

..xx xxxx Space reserved for module flow indicator 

1 SEND issued support command 

2 SEND issued unsupported command 

3 DTIWBLD issued 

4 DTISCHED issued 

DTIVLOGX 


1 

2 

3 


WEBFUN value. This is explained in “vm WEB Function Codes” on 
page 215. 

SABTFLG1 field 


Module flow indicator 

1. Asynchronous CLSDST issued 

.1. Synchronous CLSDST issued 

..xx xxxx Space reserved for module flow indicator 

1 Start NIB build process 

2 INQUIRE TERMS issued 

3 Started building session parameters 

4 INQUIRE SESSPARM issued 

5 DTIVTRMI called 

6 Attempting OPNDST 

7 Invalid device or invalid bind format 

8 Unsupported auxiliary device or unsupported screen 

size 


DTIVNSEX 


1-3 Bytes 0-2 of input data field 


DTIVOPNX 


1 WEBFUN value. This is explained in “vm WEB Function Codes” on 
page 215. 

2 Zero 

3 Module flow indicator 

1 . Check failed 

..xx xxxx Space reserved for module flow indicator 

1 DTIWBLD issued 

2 DTISKED issued 
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DTIVRECX 


1 

2 

3 


WEBFUN value. This is explained in ‘vm WEB Function Codes” on 
page 215. 

Return code from CHECK macro 
Module flow indicator 


11 . 

..XX xxxx 
1 
2 

3 

4 

5 

6 

7 

8 

9 
A 
B 
C 
D 
E 
F 

10 
11 
12 

13 

14 

15 

16 
17 


Zero 

Space reserved for module flow indicator 
Major (non-recoverable) error detected 
Asynchronous device end received 
Failure sending exception response (to exception 
request) 

SEND failure trying to issue a normal response 

DTIVRECM failure 

DTINQ failure 

DTIWBLD failure 

DTIDQ failure 

Chaining accumulator error 

Error attempting to send chain format error response 

Error attempting to send RU length error response 

In purging chain state 

First in chain received 

Middle of chain received 

End of chain received 

VTAM chain indicator error 

LUSTAT- No input mechanism 

TWX read error 

Null RU with CHANGE DIRECTION processed 
Entry invalid — TAB invalid or CID mismatch 
Entry ignored — logical unit undergoing CLSDST 
DTIVLOFF called for logical unit 
Null RU without CHANGE DIRECTION processed 


DTIVRESX 

1 WEBVSRPS 


X' 15 1 

WEBVSCC 

Command check 

X' 14' 

WEBVSDC 

Data check 

X' 13 1 

WEBVSCRJ 

Command reject 

X ‘ 12 1 

WEBVSEC 

Equipment check 

X 1 11 ■ 

WEBVSDCU 

Data check and unit specify 

X' 10' 

WEBVSECU 

Equipment check and unit specify 

X 1 OF' 

WEBVSCC1 

Reflect attention, CC1 on SIO 

X' 0E 1 

WEBVSCNL 

SEND canceled - CANCEL key 

X' 0D' 

WEBVSPSL 

Presentation space integrity lost 

X'OC 1 

WEBVSVER 

Unrecoverable internal error 

X 1 08' 

WEBVSAOK 

Successful completion 

X' 07' 

WEBTWXER 

TWX read error sense X'0827 1 

X' 06' 

WEBVSNAV 

Printer not available 

x-os 1 

WEBVSIRQ 

Intervention required 
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X'04' 

WEBVSBSY 

Printer busy 


X'03' 

WEBVSERR 

Unrecoverable I/O error 


X'02' 

WEBVSLFU 

Unconditional logoff 


X'01' 

WEBVSOPC 

Operation check 

2 

VLBERCVY 




1 . 

VLBERCLR 

Clear requested 


.1. 

VLBERBRK 

Bracket error occurred 


..1. 

VLBERSDT 

Start Data Traffic required 


...1 .... 

VLBERSIG 

Signal required 


.... 1... 

VLBERCNL 

Change received 


. 1.. 

VLBERCDR 

Change direction required 


. 1. 

VLBERPSL 

Presentation space integrity lost 


.1 

VLBERHRD 

Hard error occurred 

3 

Module flow indicator 



11. 

Reserved 



..XX xxxx 

Module flow indicator 


01 

Purge logical unit 


02 

SEND requested 


03 

Error recovery pending 


04 

Error recovery in progress, request ignored 


05 

Error element not found 


06 

Unrecoverable error occurred 


07 

Dequeue failure 


08 

Logical unit being purged 


14 

Invalid entry- 

-TAB invalid or CID mismatch 


15 

Entry ignored 

— logical unit undergoing CLSDST 

DTIVRLQX 




1-3 

Zero 



DTIVSCIX 




1 

Request code 



2 

UNBIND type 



3 

Zero 



DTIVSNDX 




1 

WEBVSRPS 




X 1 15' 

WEBVSCC 

Command check 


X' 14' 

WEBVSDC 

Data check 


X'13‘ 

WEBVSCRJ 

Command reject 


X'12‘ 

WEBVSEC 

Equipment check 


X' 11' 

WEBVSDCU 

Data check and unit specify 


X'10' 

WEBVSECU 

Equipment check and unit specify 


X'OF' 

WEBVSCC1 

Reflect attention, CC1 on SIO 


X'OE' 

WEBVSCNL 

SEND canceled - CANCEL key 


X'OD' 

WEBVSPSL 

Presentation space integrity lost 
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X'OC' 

WEBVSVER 

Unrecoverable internal error 

X'08' 

WEBVSAOK 

Successful completion 

X’07' 

WEBTWXER 

TWX read error sense X'0827' 

X'06' 

WEBVSNAV 

Printer not available 

X'05' 

WEBVSIRQ 

Intervention required 

X'04' 

WEBVSBSY 

Printer busy 

X‘03' 

WEBVSERR 

Unrecoverable I/O error 

X'02‘ 

WEBVSLFU 

Unconditional logoff 

X'01' 

WEBVSOPC 

Operation check 

VLBERCVY 



1. 

VLBERCLR 

Clear requested 

.1. 

VLBERBRK 

Bracket error occurred 

..1. 

VLBERSDT 

Start Data Traffic required 

...1 .... 

VLBERSIG 

Signal required 

.... 1... 

VLBERCNL 

Change received 

.1.. 

VLBERCDR 

Change direction required 

• • • • • « 1« 

VLBERPSL 

Presentation space integrity lost 

• ••• • • • X 

VLBERHRD 

Hard error occurred 

Module flow indicator 


1. 

DTIVPURG called 

• 1• • 

DTIVLOFF called 

••1* •••• 

Entry ignored 

— logical unit undergoing CLSDST 

•••X •••• 

Entry invalid - 

- TAB invalid or CID mismatch 
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vm Format for VTAM Exit Data Trace Entries 

These trace records are created when: 

• Minimum data is available 

• vtam issues an invalid request to vscs 

• vtam calls fail validity checks. 

DTIVCLSX 


00 

V 

C L S 

04 

RPL REQ 

RPL address 

08 

DTITAB address 

OC 

RPL CID 

10 

Zero 

1C 

FF 

DTIWEB address or zero 


Displacement: 

00-03 Characters'VCLS' 

04 RPL request code 

05-07 RPL address 

08-0B Invalid TAB address 

0C-0F RPL CID 

10 — IB Zero 

1C X'FF 1 to indicate data trace entry 

ID-IF WEB address or zero 

DTIVDFAX 




00 

V 

D 

F 

A 

04 

ACB address 

08 

RPL CID 

OC 

DTITAB address 

10 

Zero 

14 

RPL address 

18 

Zero 

1C 

FF 

WEBFUN 

Zero 

Mod. flow 


Displacement: 

00 - 03 Characters ‘VDFA’ 
04- 07 Input ACB address 
08 —0B Input CID 
0C - OF Input TAB address 
10-13 Zero 

14- 17 Input RPL address 
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18 — 1B Zero 

1C X'FF 1 to indicate data trace entry 

ID WEBFUN value. This is explained in "vm WEB Function Codes” on 

page 215. 

IE Zero 

IF Module flow indicator 

1. DTIVPURG called 

..xx xxxx Module flow indicator 

1 SEND issued supported command 

2 SEND issued unsupported command 

3 DTIWBLD issued 

4 DTISCHED issued 



Displacement: 


00 - 03 Characters ‘VLOG’ 

04- 07 Input ACB address 

08-0B Address of logical unit name 

0C-0F Zero 

10- 13 Length of logon message 

14—IB Logical unit name 

1C X'FF 1 to indicate data trace entry 

ID WEBFUN value. This is explained in "vm WEB Function Codes” on 

page 215. 

IE SABTFLG1 field 

IF Module flow indicator 


1 . 

.1 . 

. .xx xxxx 
1 
2 

3 

4 

5 

6 

7 

8 


Asynchronous CLSDST issued 

Synchronous CLSDST issued 

Module flow indicators 

Start NIB build process 

INQUIRE TERMS issued 

Started building session parameters 

INQUIRE SESSPARM issued 

DTIVTRMI called 

Attempting OPNDST 

Invalid device or invalid BIND format 

Unsupported auxiliary device or unsupported screen size 
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DTIVLOSX 


00 

V 

L 0 

S 

04 

ACB address 

08 

RPL CID 

0C 

NIB user field 

10 

Reason code 

14 

DTITAB address 

18 

DTIWEB address 

1C 

FF 

Zero 

Mod. flow 


Displacement: 

00-03 Characters ‘VLOS’ 

04—07 Input ACB address 
08-0B InputCID 
0C - OF Input NIB user field 
10-13 Reason code 

0C Contact lost 
14 Unconditional logoff 
20 Conditional logoff 
24 Buffer limit 
14-17 TAB address or zeros 
18 -1B WEB address or zeros 
1C X'FF' to indicate data trace entry 

ID-IE Zero 

IF Module flow indicator 

1. DTIVPURG called 

..xx xxxx Module flow indicator 

1 DTIWBLD issued 

2 DTISKED issued 


DTIVNSEX 


00 

V 

N S E 

04 

ACB address 

08 

RPL CID 

0C 

DTITAB address 

10 

Zero 

14 

RPL address 

18 

RPL REQ 

RPL address 

1C 

FF 

Bytes 0 - 2 of user data field 
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Displacement: 

00-03 Characters 'VNSE’ 

04-07 Input ACB address 
08 — OB Input CID 
0C - OF Input TAB address 
10-13 Zero 

14-17 Input RPL address 

18 RPL request code 

19- IB Input RPL address 

1C X' FF 1 to indicate data trace entry 

ID - IF First three bytes of input data field 


DTIVOPNX 


00 

V 

0 

P 

N 

04 

RPL REQ 

RPL address 

08 

DTITAB address 

OC 

Zero 

1C 

FF 

WEBFUN 

Zero 

Mod. flow 


Displacement: 


00-03 Characters ‘VOPN’ 

04 RPL request code 
05-07 Input RPL address 
08-0B Invalid TAB address 
0C-1B Zero 

1C X'FF' to indicate data trace entry 

ID WEBFUN. This is explained in “vm WEB Function Codes” on page 215. 
IE Zero 

IF Module flow indicator 

1. Check failed 

..xx xxxx Module flow indicator 

1 DTIWBLD issued 

2 DTISKED issued 


DTIVRECX 


00 

V 

R 

E 

C 

04 

RPL REQ 

RPL address 

08 

DTITAB address 

OC 

DTIVLB address 

10 

DTIWEB address 

14 

Zero 

1C 

FF 

WEBFUN 

CHK RC 

Mod. Flow 
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Displacement: 

00-03 Characters 'VREC 1 
04 RPL request code 
05 - 07 Input RPL address 
08 - OB Invalid TAB address 
0C - OF VLB address 
10- 13 Input WEB address 
14-IB Zero 

1C X'FF' to indicate data trace entry 

ID WEBFUN. This is explained in “vm WEB Function Codes” on page 215. 
IE Return code from CHECK macro 
IF Module flow indicator 

11. Zero 

..xx xxxx Module flow indicator 

1 Major (non-recoverable) error detected 

2 Asynchronous device end received 

3 Failure sending exception response (to exception 
request) 

4 SEND failure trying to issue a normal response 

5 DTIVRECM failure 

6 DTINQ failure 

7 DTIWBLD failure 

8 DTIDQ failure 

9 Chaining accumulator error 

A Error attempting to send chain format error response 
B Error attempting to send RU length error response 
C In purging chain state 
D First in chain received 
E Middle of chain received 
F End of chain received 

10 VTAM chain indicator error 

11 LUSTAT = No input mechanism 

12 TWX read error 

13 Null RU with CHANGE DIRECTION processed 

14 Invalid entry — TAB invalid or CID mismatch 

15 Entry ignored — logical unit undergoing CLSDST 

16 DTIVLOFF called for logical unit 

17 Null RU without CHANGE DIRECTION processed 
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DTIVRESX 

Note: This trace record is created only when exception response is used. 


00 

V 


R 

E 

S 

04 

REQCODE 


RPL 

ADD 

R E S S 

08 

D T 

I T A B 

ADDRESS 

OC 

D T 

I V L B 

ADDRESS 

10 

D T 

I WEB 

ADDRESS 

14 


R E S E R V 

E D 


1C 

X'FF' 

RESERVED 

RESERVED 

MOD FLOW 


Displacement: 


00-03 Characters‘VRES’ 

04 RPL request code 
05-07 RPL address 
08 —0B TAB address 
0C—OF VLB address 
10-13 WEB address 
14—17 Zero 

1C X' FF 1 to indicate data trace entry 
ID-IE Zero 

1F Module flow indicator 
11. Reserved 


..xx xxxx 
01 
02 
03 
04 
05 
06 
07 
08 

14 

15 


Module flow indicator 

Purge logical unit 

SEND requested 

Error recovery pending 

Error recovery in progress, request ignored 

Error element not found 

Unrecoverable error occurred 

Dequeue failure 

Logical unit being purged 

Invalid entry— TAB invalid or CID mismatch 

Entry ignored — logical unit undergoing CLSDST 
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DTIVRLQX 



Displacement: 

00 - 03 Characters 'VRLQ' 

04-OB ACB name 

0C-13 Logical unit name 

14-17 TAB address 

18-IB Zero 

1C X 1 FF' to indicate data trace entry 

ID Return code 

IE-IF Zero 

DTIVSCIX 




GO 

V 

s 

C 

I 

04 

ACB address 

08 

CID (not used) 

OC 

DTITAB address 

10 

Zero 

14 

RPL address 

18 

RPLREQ 

RPL address 

1C 

FF 

Req code 

Unbind 

Zero 


Displacement: 

00-03 

Characters 'VSCI' 

04-07 

ACB address 

08-0B 

CID (not used) 

0C — IF 

DTITAB address 

10-13 

Zero 

14-17 

RPL address 

18 

RPL request 

19— IB 

RPL address 

1C 

X'FF' to indicate data trace entry 

ID 

Request code 

IE 

Unbind type 

IF 

Zero 
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DTIVSIMX 


00 

V 

S I M 

04 

RPL REQ 

RPL address 

08 

RPLFDBWD 

0C 

RPLFDBK2 

10 

LU name 

18 

DTITAB address 

1C 

FF 

Return code from CHECK macro 


Displacement: 

00-03 Characters'VSIM' 

04 RPL request code 

05-07 Input RPL address 

08-0B RPL feedback word 

0C-0F RPLFDBK2 

10—17 Logical unit name 

18-IB DTITAB address 

1C X'FF' to indicate data trace entry 

1D -1F Return code from CHECK macro 

DTIVSEND 

Note: This trace record is created only when exception response is used. 


00 


04 


08 


0C 


10 


14 


18 


1C 


V 

S 

E 

N 

0 T I 

TAB 

ADDRESS 

0 T I 

W E B 

A D D R 

E S S 

XMTFLG1 

XMTFLG2 

MODE/TYPE 

LBCSTATE 

PLBFSSMF 

PLBLFLG1 

PLBNFLG1 

PLB0FLG1 

VLBLRCD 

VLBERFLG 

VLBERSQ1 

VLBSWAP 

X'FF' 

CALLER'S RETURN ADDRESS 


Displacement: 

00-03 Characters ‘VSEN' 

04 — 07 DTITAB address 

08-0B DTIWEB address (DTICMT, DTI WEB, DTIXMT) 

0C XMTFLG1 - Transmit flag 1 

1. XMTCD Change direction required (for start/stop) 

.1 . XMTRSHOW Redisplay in DTIXMT buffer 

.. 1. XMTPMSG Priority message on screen 
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...1 .... XMTDIAG CMS DIAGNOSE on screen 

.... 1... XMTLRO Logo RU 

.1.. XMTATTN Attention write (VSCS only) yes = 1 

.1. XMTINPT Input expected from logical unit 

.1 XMTPWMSK Password mask 

OD XMTFLG2 - Transmit flag 2 

1. XMTVDATR DTIVDATR called 

.1. XMTERCMT DTIXMT is really a DTICMT 

..1. XMTERERR Error retry necessary 

... 1 _ XMTERPSL Presentation space integrity lost 

.... 1... XMTLMPEO LMPEO SEND initiated 

.Ill Zero 

OE MODE or TYPE of request 

B Busy 

C Control command 
D Definite response 
E Exception response 
P Logical unit purged 
X Recovery request 
W Logical unit waiting 

OF LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 

page 214.) 

1. LBCINT Internal mode if on (on = 1). If LBCINT is 

on, see “vm LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

.11. LBCFSSMF Full-screen support mode flags 

.1. LBCFSAV Screen available 

..1. LBCFSII Full-screen input inhibited: 

B'OO’ CP (Console) mode 
B'01’ Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10' Virtual machine mode queue CP 
messages. 

B'l 1' Virtual machine mode available 
for switch. 


1 .... 

LBCCOPY 

Copy mode: on = 1 

. 1 ... 

LBCNAL 

NALflag: on = 1 

. .11. 

LBCHOLD 

Holding flag: on = B‘11' 

. . 1 .. 

LBCM10 

‘More’ 10 flag: on= 1 

. .. 1 . 

LBCM50 

‘More’ 50 flag: on = 1 

. ...1 

LBCCMSD 

Screen written with a CMS DIAGNOSIS 


on = 1 

No more holding state 


10 PLBFSSMF — Full-screen support mode flags 

1 . PLBFPA1 PA1 key received switch mode 

.1 . PLBFSRFC Mode switch required (FSSM to Console) 

.. 1 . PLBFSAFC Switch available (FSSM to Console) 
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11 


12 


13 


14 


...1 

.... 

PLBFCNMP 

Console message pending 


i... 

PLBFVSIP 

VTAM Services SEND in progress 

• • • • 

.i.. 

PLBFCLGF 

Conditional logoff received 

• • • « 

..i. 

PLBFCMRR 

CP message pending, response required 

• • • • 

...i 

PLBCMSEW 

Screen has just been erased 

PLBLFLG1 

- VTAM Services logoff flags for Presentation Services 

1... 

.... 

PLBLVS 

VTAM Services logoff received, bypass 
logo 

.1.. 

.... 

PLBLGFC 

WEBINLGF sent to CCS conditional logoff 

..1. 

.... 

PLBLGFU 

WEBINLGF sent to CCS unconditional 
logoff 

...1 

.... 

PLBLERR 

WEBINERR sent to CCS for hard error 


i... 

PLBLLERR 

WEBINLER sent to CCS for interface 

error 

.... 

.1.. 

PLBLVERR 

WEBINVER sent to CCS for internal logic 
error 

.... 

..i. 

PLBLSEVR 

CP CCS SEVER received, must sever 

.... 

...i 

PLBLNSTR 

No storage indicator in logoff 

PLBNFLG1 

- NOM flag 1 


1... 


PLBCEND 

Command end (read) 

.1.. 


PLBRDTX 

The redisplay timer has expired 

..1. 

.... 

PLBSAC 

Status area change required 

...1 

• • • • 

PLBCLROA 

Clear output area 

• • • * 

i... 

PLBCLRIA 

Clear input area 

• i • # 

.i.. 

PLBRING 

Ring the alarm 

• • t • 

..i. 


Zero 

• • l • 

...i 

PLBUNLK 

Unlock keyboard 

PLBOFLG1 

— Output manager flags 

1... 

.... 

PLBSDIAG 

CMS DIAGNOSE on screen 

.1.. 

.... 

PLBPSMSG 

Priority message on screen 

..1. 

• • • • 

PLBOSRIP 

SEND retry in progress 

...1 

• • • • 

PLBOKLOK 

Keyboard locked 

• • • • 

i... 

PLBOKPMI 

Keyboard printer mask input area sent 

• • • • 

.i.. 

PLBOSWRT 

CMS WRITE active (no input received) 

.... 

..i. 

PLBOCRRQ 

Carriage return required before SEND on 
hardcopy terminal 

.... 

...i 

PLBOEXRQ 

T required before SEND on hardcopy ter¬ 
minal 

VLBLRCD - 

- Logoff reason 

codes 

1... 

•... 

VLBVTLO 

VTAM LOGOFF 

.1.. 

• • • • 

VLBVRYI 

VARY INACTIVE 

..1. 

• • • • 

VLBHLTQ 

HALT QUICK 

...1 

.... 

VLBHLTC 

HALT CANCEL 

.... 

1... 

VLBIOE 

Unrecoverable I/O error 

.... 

.1.. 

VLBINERR 

Internal error 

• • • • 

..11 


Zero 

VLBERFLG 

— Exception response flags 

1... 

.... 

VLBPSHLD 

DTIXMT pending (PS held) 
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.1. VLBERPND Error recovery pending 

. .1. VLBERRIP Error recovery in progress 

... 1 .... VLBERPRG Permanent error: purge logical unit 

.... 1... VLBPRGDN Purge complete 

.1.. VLBERPRM Permanent error 

.1. VLBEREXT Exit receive control before return 

.1 VLBRCVNO Do not reissue RECEIVE SPECIFIC for 

logical unit 

16 — 17 VLBERSQ1 — Sequence number of first error 

18 VLBFLG - VLB flag 

1. VLBBSPBB Bracket-state pending begin bracket 

.1. VLBBSPEB Bracket-state pending end bracket 

..1. VLBBSINB Bracket-state in bracket 

... 1 .... VLBSR Application SEND or RECEIVE state: 

1 = SEND state, 0 = RECEIVE state 
.... 1111 Zero 

19 VLBFLG1 - VLB flag 1 

1. VLBIOTR Inbound data received since last SEND 

.1. VLBCLSD CLSDST not required 

..1. VLBPCS Purging chain state 

... 1 .... VLBSIGNL Signal sent 

.... 1... VLBCHGD Change direction required 

.1.. VLBRETR Retry RECEIVE request 

.1. VLBRETS Retry SEND request 

.1 Zero 

1A VLBFLG2 - VLB flag 2 

1. VLBRPLB RPL in use 

.1. VLBCLPND VTAM CLSDST pending 

..11_ Zero 

.... 1... VLBBUSY Printer busy 

.1.. VLBNAV Printer not available 

.1. VLBOPCK Operation check occurred 

.1 VLBWAIT Waiting for data or LUSTAT 

1B VLBSENDF — Special function flags 

1. VLBCLR Clear required 

.1. VLBSDT Start data traffic (SDT) required 

..1. VLBCANC Cancel required 

...1 .... VLBSIGRQ Signal required 

.... 1111 Zero 

1C X' FF‘ to indicate data trace entry 

ID - IF Caller's return address 
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Displacement: 

00-03 Characters‘VSND' 

04 RPL request code 

05 - 07 Input RPL address 

08-0B Invalid TAB address 

0C-0F VTAM Services local block (VLB) address 

10-13 Input WEB address 

14-IB Zero 

1C X'FF' to indicate data trace entry 
ID WEBVSRPS 


X'15 1 

WEBVSCC 

Command check 

X'14 1 

WEBVSDC 

Data check 

X'13 1 

WEBVSCRJ 

Command reject 

X‘12' 

WEBVSEC 

Equipment check 

X'll' 

WEBVSDCU 

Data check and unit specify 

X'10' 

WEBVSECU 

Equipment check and unit specify 

X'OF 1 

WEBVSCC1 

Reflect attention, CC1 on SIO 

X'OE' 

WEBVSCNL 

SEND canceled - CANCEL key 

X'OD' 

WEBVSPSL 

Presentation space integrity lost 

X'OC' 

WEBVSVER 

Unrecoverable internal error 

X'08‘ 

WEBVSAOK 

Successful completion 

X'07‘ 

WEBTWXER 

TWX read error sense X'0827' 

X'06' 

WEBVSNAV 

Printer not available 

X'05' 

WEBVSIRQ 

Intervention required 

X'04' 

WEBVSBSY 

Printer busy 

X'03' 

WEBVSERR 

Unrecoverable I/O error 

X'02' 

WEBVSLFU 

Unconditional logoff 

x'or 

WEBVSOPC 

Operation check 


IE Zero 
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IF Module flow indicator 

1. DTIVPURG called 

.1. DTIVLOFF called 

. .1. Entry ignored — logical unit undergoing CLSDST 

...1 - Entry invalid — TAB invalid or CID mismatch 


vm Cleanup Error Trace Record Format 

The vscs cleanup trace is activated automatically if any of the other vscs traces are 
active. The cleanup trace applies only to the set of logical units specified for the 
other vscs traces. Normal session terminations and error situations are traced. 
Two kinds of cleanup trace records are produced: 

• Logical unit-related 

• Data-related (associated with vscs global path). 

vm Format for a Cleanup Error Trace Entry 


00 


Module 

; ID 


04 

WEBFUN 

DTITAB address 

08 

RPL REQ 

LBCSTATE 

PLBFSSMF 

PLBLFLG1 

OC 

PLBFLG1 

PLBN0M 

PLB0FLG1 

10 

; LBCSTATE 

VLBLRCD 

Zero 

14 

VLBSWAP 

18 

VLBCID 

1C 

TRCFL0W 

DTIWEB or RPL address 


Displacement: 

00-03 Four-character module ID (characters 4 PBRK’ or 'VPUR’) 

04 WEBFUN code or zero (See “ vm WEB Function Codes" on page 215.) 

05 - 07 TAB address for current request 
08 RPL request code 

09 LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx" on 

page 214.) 

1 . LBCINT Internal mode if on (on = 1). If LBCINT is 

on, see “ vm LBCSTATE Values for 
PLBINxxx" on page 214. If LBCINT is off, 
the following values apply: 

.11 . LBCFSSMF Full-screen support mode flags 

.1 . LBCFSAV Screen available 
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LBCFSII 

Full-screen input inhibited: 



LBCCOPY 

B'OO’ CP (Console) MODE 

B‘01' Virtual machine mode state 
between ATTN and READ, 

QUEUE CP messages 

B'10’ Virtual machine mode queue CP 
messages 

B‘ 11 ’ Virtual machine mode available 
for switch. 

Copy mode: on = 1 


_ 1 ... 

LBCNAL 

NALflag: on = 1 


.11. 

LBCHOLD 

Holding flag: on = B‘11' 


. 1.. 

LBCM10 

‘More’ 10 flag: on = 1 


. 1. 

LBCM50 

'More'50 flag: on = 1 


. 1 

LBCCMSD 

Screen written with a CMS DIAGNOSE: 

OA 

PLBFSSMF 

on = 1 

No more holding state 

Full-screen support mode flags 


1 . 

PLBFPA1 

PA1 key received switch mode 


.1. 

PLBFSRFC 

Mode switch required (FSSM to Console) 


# .l. 

PLBFSAFC 

Switch available (FSSM to Console) 



PLBFCNMP 

Console message pending 


_1... 

PLBFVSIP 

VTAM Services SEND in progress 


• ••• t 1 • • 

PLBFCLGF 

Conditional logoff received 


• ••• « • 1 » 

PLBFCMRR 

CP message pending, response required 


. 1 

PLBCMSEW 

Screen just cleared 

OB 

PLBLFLG1 

PLBVS 

VTAM Services logoff received bypass 



PLBLGFC 

logo 

WEBINLGF sent to CCS conditional logoff 


..1 . 

PLBLGFU 

WEBINLGF sent to CCS unconditional 


•••X «••« 

PLBLERR 

logoff 

WEBINERR sent to CCS for hard error 


• ••« 1 ■ * • 

PLBLLERR 

WEBINLER sent to CCS for interface 


• •»• • X • • 

PLBLVERR 

error 

WEBINVER sent to CCS for internal logic 


. 1# 

PLBLSEVR 

error 

CP CCS SEVER received, VSCS must 


. J 

PLBNSTR 

sever 

No storage indicator in logoff processing 

OC 

PLBFLG1 

PLBLGO 

Logo or no logo bit (logo = 1) 


.1 . 

PLBINAR 

APL or TEXT starting in input area 


. .1 . 

PLBPASPA 

Pass PA1 as data (FSSM; VTAM V3R1 


. 

PLBLFLNP 

only) 

Logon from logo not permitted 


...1 .... 

PLBCONCT 

Current connect count incremented for 


.... 1 ... 

PLBCNCTI 

logical unit 

IUCV CONNECT has been issued 
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. 1.. 

PLBINREC 

Input received during purge 


. 1- 

PLBPRMPT 

Usability prompt message flag. 




For display terminals: CP READ 
received but prompt not sent. 




For hardcopy terminals: VSCS sent 
prompt to logical unit. 


.1 


Zero (VTAM V3R1 only) 


. .1 

PLBSDIAL 

SNA-dialed logical unit 

0D-0E 

PLBNOM 

Notify output manager 

0D 

PLBNFLG1 

NOM flag 1 



1. 

PLBCEND 

Command end (read) 


.1. 

PLBRDTX 

The redisplay timer has expired 


..1. 

PLBSAC 

Status area change required 


...1_ 

PLBCLROA 

Clear output area 


.... 1... 

PLBCLRIA 

Clear input area 


.1.. 

PLBRING 

Ring the alarm 


. 1. 


Zero 


• » * * • • • 1 

PLBUNLK 

Unlock keyboard 

0E 

PLBNFLG2 

NOM flag 2 



1 • • • «•«• 

PLBRDPND 

Redisplay pending 


.111 1111 


Zero 

OF 

PLBOFLG1 

Output manager flags 


X••• •••• 

PLBSDIAG 

CMS DIAGNOSE on screen 


«1 •« •••« 

PLBPSMSG 

Priority message on screen 


•••« 

PLBOSRIP 

SEND retry in progress 


*»«1 •••• 

PLBOKLOK 

Keyboard locked 


• ••• 1 •• • 

PLBOKPMI 

Hardcopy terminal mask input area sent 


»••i tit* 

PLBOSWRT 

CMS WRITE active (no input received) 


• • • • *• 1 • 

PLBOCRRQ 

Carriage return required before SEND 
(on hardcopy terminal) 


• ••• »«• 1 

PLBOEXRQ 

T required before SEND (on hardcopy 
terminal) 

10 

LBCSTATE 

From VLB 



• ••• • • a 1 

LBCVSST 

VTAM Services state: 0 = Normal, 

1 = Termination 

11 

VLBLRCD 

Logoff reason 

codes 


1 a a a aaaa 

VLBVTLO 

VTAM LOGOFF 


• 1 . 

VLBVRYI 

VARY INACTIVE 


a.l. 

VLBHLTQ 

HALT QUICK 


a a a 1 aaaa 

VLBHLTC 

HALT CANCEL 


aaaa laaa 

VLBIOE 

Unrecoverable I/O error 


.la. 

VLBINERR 

Internal error 


aaaa till 


Zero 

12-13 

Zero 



14 

VLBFLG 

VLB flags 



1. 

VLBBSPBB 

Bracket state - pending begin bracket 
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• 1. 

VLBBSPEB 

Bracket state - pending end bracket 


..1. 

VLBBSINB 

Bracket state - in bracket 


...1 .... 

VLBSR 

Application SEND or RECEIVE state: 

1 = SEND state, 0 = RECEIVE state 


.... 1111 


Zero 

15 

VLBFLG1 

VLB flag 1 



1 . 

VLBIOTR 

Inbound data received since last SEND 
indicator 


.1. 

VLBCLSD 

. CLSDST: 0 = required, 1 = not 




required 


..1. 

VLBPCS 

Purging chain state 


...1 .... 

VLBSIGNL 

Signal sent 


.... 1... 

VLBCHGD 

Change direction required 


.1.. 

VLBRETR 

Retry RECEIVE request 


.1. 

VLBRETS 

Retry SEND request 


.1 


Zero 

16 

VLBFLG2 

VLB flag 2 



1. 

VLBRPLB 

RPL in use 


.1. 

VLBCLPND 

VTAM CLSDST pending 


..11 .... 


Zero 


.... 1... 

VLBBUSY 

Printer busy 


.1.. 

VLBNAV 

Printer not available 


.1. 

VLBOPCK 

Operation check occurred 


.1 

VLBWAIT 

Waiting for data or LUSTAT 

17 

VLBSENDF 

Special send indicator 


i.«. .... 

VLBCLR 

CLEAR required 


.i. 

VLBSDT 

SDT required 


..i. 

VLBCANC 

CANCEL required 


...i .... 

VLBSIGRQ 

SIGNAL required 


.... nil 


Zero 

18 — IB 

VLBCID 

Network address pair (CID) 

19 

TRCFLOW 

Cleanup-module-dependent data 

ID — IF 

Address 

DTI WEB if WEBFUN not zero, RPL if RPLREQ not zero 
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Cleanup-Module-Dependent Data 

DTIPRBRK (ID = ‘PBRK’): Trace flow flags are set as follows: 

01 TRXPURG Logical unit in PLBINPRG (88) state 

02 TRXNWEB No input WEB 

03 TRXLOGO Logo error 

04 TRXCOND Conditional logoff 

DTIVPURG (ID = ‘VPUR’): Trace flow flags are set as follows: 

1. Schedule failed 

.1. Storage shortage 


. .XX xxxx 

Space reserved for module flow indicator 

01 

TRXNTERM 

NOTERM entered 

02 

TRXLTERM 

Logical unit in termination 

03 

TRXWORK 

VSCS ignoring work to process request 

04 

TRXNWORK 

No work to process DTIVLOFF called 

05 

TRXCONN 

Logical unit in termination state with CCS con¬ 
nection 

06 

TRXACTIV 

Logical unit state is not termination with no con¬ 
nection 

07 

TRXIGNOR 

CCS has been notified or DTIPRBRK has set a 
timer to force purge. VSCS is waiting. 
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VM VSCS FORCE Trace Entry (V3R2) 


Q0 

P 

F 

0 

R 

04 

DTITAB 

ADDRESS 

08 

LBCSTATE 

PLBLFLG1 

PLBNFLG1 

PLB0FLG1 

0C 

TABDTYPE 

TABDSUB 

LBCSTATE 

VLBLRCD 

10 

VLBSWAP 

14 

LU NAME 

1C 

'FF' 

MOD FLOW 1 

MOD FLOW 2 

MOD IND 


Displacement: 

00-03 Four-character module ID 
04-07 Tab address for current request 

08 LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 

page 214.) 



LBCINT 

Internal mode if on (on = 1). If LBCINT is 
on, see “vm LBCSTATE Values for 
PLBINxxx" on page 214. If LBCINT is off, 
the following values apply: 

11. 

LBCFSSMF 

Full-screen support mode flags 

1. 

LBCFSAV 

Screen available 

.1. 

LBCFSII 

Full-screen input inhibited: 


B‘00’ CP (Console) mode 

B’OT Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10’ Virtual machine mode queue CP 
messages. 

B‘1T Virtual machine mode available 
for switch. 


...1 .... 

LBCCOPY 

Copy mode: on = 1 

.... 1 ... 

LBCNAL 

NALflag: on = 1 

.11. 

LBCHOLD 

Holding flag: on = B*11’ 

. 1 .. 

LBCM10 

‘More’ 10 flag: on = 1 

.1 . 

LBCM50 

‘More’ 50 flag: on = 1 

.1 

LBCCMSD 

Screen written with a CMS DIAGNOSIS: 

on = 1 

PLBLFLG1 


No more holding state 

1. 

PLBVS 

VTAM Services logoff received bypass 
logo 

.1. 

PLBLGFC 

WEBINLGF sent to CCS conditional logoff 

..1 . 

PLBLGFU 

WEBINLGF sent to CCS unconditional 
logoff 

...1 .... 

PLBLERR 

WEBINERR sent to CCS for hard error 
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.... 

1 ... 

PLBLLERR 

WEBINLER sent to CCS for interface 

error 


. 1 .. 

PLBLVERR 

WEBINVER sent to CCS for internal logic 
error 

.... 

.. 1 . 

PLBLSEVR 

CP CCS SEVER received, VSCS must 

sever 

« • • ♦ 

...1 

PLBNSTR 

No storage indicator in logoff processing 

PLBNOM 

Notify output 

manager 

PLBNFLG1 

NOM flag 1 


1 ... 

• « « • 

PLBCEND 

Command end (read) 

. 1 .. 

• • • . 

PLBRDTX 

The redisplay timer has expired 

.. 1 . 

.... 

PLBSAC 

Status area change required 

...1 

.... 

PLBCLROA 

Clear output area 

.... 

1 ... 

PLBCLRIA 

Clear input area 

.... 

. 1 .. 

PLBRING 

Ring the alarm 

■ • • • 

.. 1 . 


Zero 

.... 

...1 

PLBUNLK 

Unlock keyboard 

PLBOFLG1 

Output manager flags 

1 ... 

.... 

PLBSDIAG 

CMS DIAGNOSE on screen 

. 1 .. 


PLBPSMSG 

Priority message on screen 

.. 1 . 


PLBOSRIP 

SEND retry in progress 

...1 


PLBOKLOK 

Keyboard locked 

• • # • 

1 ... 

PLBOKPMI 

Hardcopy terminal mask input area sent 

• * • • 

. 1 .. 

PLBOSWRT 

CMS WRITE active (no input received) 

* • • • 

.. 1 . 

PLBOCRRQ 

Carriage return required before SEND 
(on hardcopy terminal) 

• • • I 

...1 

PLBOEXRQ 

T required before SEND (on hardcopy 
terminal) 


OC TABDTYPE 


01 DTYPEDSP for a display 
02 DTYPEKP for a keyboard/printer 
02 DTYPEPRT for a printer 
OC TABDSUB 


01 VDEV3767 for a 3767 
02 VDEV2741 for a 2741 
02 VDEVTWX for a TXW/TTY/3101 


LBCSTATE 

VLB 


.1 

LBCVSST 

VTAM Services state: 0 = Normal, 
1 = Termination 

VLBLRCD 

Logoff reason codes 

1 . 

VLBVTLO 

VTAM LOGOFF 

.1 . 

VLBVRYI 

VARY INACTIVE 

..1 . 

VLBHLTQ 

HALT QUICK 

...1 .... 

VLBHLTC 

HALT CANCEL 

.... 1 ... 

VLBIOE 

Unrecoverable I/O error 

«••• . la * 

VLBINERR 

Internal error 

. • . • < « 11 
VLBFLG 

VLB flags 

Zero 
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...1 .... 

.... 1111 

11 VLBFLG1 

.1 . 

. 1 . 

. 1 

12 VLBFLG2 

1 . 

.1 . 

..11 .... 

. 1 .. 

. 1 . 

IB VLBSENDF 

.... 1111 
14-IB TABLUNM 

1C 
ID 

1 ... 

. 1 .. 

.. 1 . 

...1 


IE 

1 ... 

. 1 .. 

.. 1 . 

...1 


1 ... 

. 1 .. 

.. 1 . 

...1 


VLBBSPBB Bracket state-pending begin bracket 


VLBBSPEB Bracket state-pending end bracket 

VLBBSINB Bracket state-in bracket 

VLBSR Application SEND or RECEIVE state: 

1 = SEND state, 0 = RECEIVE state 
Zero 


VLB flag 1 
VLBIOTR 

VLBCLSD 

VLBPCS 

VLBSIGNL 

VLBCHGD 

VLBRETR 

VLBRETS 

VLB flag 2 
VLBRPLB 
VLBCLPND 


Inbound data received since last SEND 
indicator 

CLSDST: 0 = required, 1 = not 
required 

Purging chain state 
Signal sent 

Change direction required 
Retry RECEIVE request 
Retry SEND request 
Zero 

RPL in use 

VTAM CLSDST pending 
Zero 


VLBBUSY Printer busy 

VLBNAV Printer not available 

VLBOPCK Operation check occurred 

VLBWAIT Waiting for data or LUSTAT 

Special function flags 
VLBCLR Clear required 


VLBSDT 

VLBCANC 

VLBSIGRQ 


SDT required 
Cancel required 
Signal required 
Zero 


Logical unit name being forced 

X'FF 1 to indicate data trace entry 

Module flow indicator 1 done by SPECIALX 

SPECIALX called 

CONECTYS called 

CONECTNO called 

COPYSIT called 

DTIPRCLP called 

DTIPRBRK called 

DTIPRSVR called 

DTIPRLGF called 


Module flow indicator 2 done by SPECIALX 

SPECIALX called 

CONECTYS called 

CONECTNO called 

COPYSIT called 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Chapter 6. vm Using VSCS Service Aids 211 












“Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


_ 1... DTIPRCLP called 

.1.. DTIPRBRK called 

.1. DTIPRSVR called 

.1 DTIPRLGF called 

IF Queue status indicators 

1. LUNORMAL Logical unit control blocks on normal 

queue 

.1. LUREC Logical unit control blocks on recovery 

queue 

.. 1. LUPQUEUE PS PIB on PS dispatcher queue 

...1 _ LUVQUEUE VS PIB on VS dispatcher queue 

.... 1... LUBFKPIB WEBCPBRK on PS PIB work queue 

.1.. LUBRKLBC WEBCPBRK on LBC pending queue 

.1. LUVSBRK WEBVSBRK found on one of the work 

queues 

.1 LUNTF60 WEBNTF60 found on PS PIB 


vm VSCS Storage Trace Entries 

vm FREB Trace Entry (V3R2) 


00 

F R 

E B 

04 

DTIPDB 

ADDRESS 

08 

BLOCK 

ADDRESS 

OC 

BLOCK ID 

HEADER ID 

10 

POOL 

NUMBER 

14 

RETURN1 

ADDRESS 

18 

RETURN2 

ADDRESS 

1C 

RESERVED 


Displacement: 

00-03 Characters ‘FREB’ 

04 - 07 DTIPDB address 
08 - 0B Block being freed 
0C-0D SMP header 
0E-0F Block ID 
10 Storage pool number 

1 Presentation Services 

2 VTAM Services 

3 VTAM Exit Services 
11-13 Zero 

14- 17 Caller's return address 

18 - IB Caller's caller's return address 

1C — 1F Zero 
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GETB Trace Entry (V3R2) 


00 

G E 

T B 

04 

DTIPDB 

ADDRESS 

08 

BLOCK 

ADDRESS 

OC 

REQ SIZE 

CLR SIZE 

10 

POOL 

NUMBER 

14 

RETURN1 

ADDRESS 

18 

| RETURN2 

ADDRESS 

1C 

CALLERS 

STATE 


Displacement: 

00 - 03 Characters ‘GETB’ 

04-07 DTIPDB address 
08 - OB Block being obtained 
0C - 0D Size requested 
0E - OF Size to be cleared 
10 Storage pool number 

1 Presentation Services 

2 VTAM Services 

3 VTAM Exit Services 

4 Special request 
11-13 Zero 

14- 17 Caller's return address 
18- IB Caller's caller's return address 
1C-IF State 

ENAB Caller running enabled 
DISB Caller running disabled 


VSCS Data Trace Entries 

Input Trace Entry (V3R2) 



Displacement: 

00 Character T for Input 
01-03 DTITAB address 
04 - 07 Work element address 
08 WEB function code 
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09 WEB mode 
00 Console 
01 CMS 
02 Full-screen 
04 Internal 

0A-0B Length of actual data in WEBDATA 

10-xx WEBDATA (20 bytes for internal, or 223 bytes for external) 

v, i Output Trace Entry (V3R2) 


00 

'O' 

DTITAB 

ADDRESS 

04 


DTIWEB 

ADDRESS 

08 

WEBFUN 

WEBM0D 

WEBCOUNT 

10 



WEBDA 

T A 


Displacement: 

00 Character 'O’ for Output 

01-03 DTITAB address 
04-07 Work element address 

08 WEB function code 

09 WEB mode 

00 Console 
01 CMS 
02 Full-screen 
04 Internal 

0A-0B Length of actual data in WEBDATA 

10-xx WEBDATA (20 bytes for internal, or 223 bytes for external) 


v:v LBCSTATE Values for PLBINxxx 

vm Console Mode 


Name 

Hex Value 

Description 

PLBINNMH 

00 

No ‘More’ or ‘Holding’ condition 

PLBINM50 

02-03 

More condition, 50 second timer set 

PLBINM10 

04-05 

More condition, 10 second timer set 

PLBINHLD 

06-07 

Holding 

PLBINNAL 

08-OF 

Not Accepted logic applies 

PLBINCPY 

10— IF 

PF key Copy in progress 


CMS Edit Mode 


Name 

Hex Value 

Description 

PLBINCMS 

01 

No ‘More’ or ‘Holding’ condition 

PLBINM50 

02-03 

More condition, 50 second timer set 

PLBINM10 

04-05 

More condition, 10 second timer set 

PLBINHLD 

06-07 

Holding 

PLBINNAL 

08 - OF 

Not Accepted logic applies 
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Full-Screen Support Mode (FSSM) 

Name Hex Value Description 

PLBINFSS 20, 40, 60 Full-screen support mode 


Internal Modes 

Name 

PLBINLIP 

PLBINLUP 

PLBINCIP 

PLBINIIP 

PLBINAWL 

PLBINLGF 

PLBINCLF 

PLBINSVR 

PLBINPRG 


Hex Value 

Description 

80 

Logon in progress 

81 

Logo up 

82 

Connect in progress 

83 

Inlog in progress 

84 

Attention wait before logo 

85 

Logoff 

86 

Conditional logoff 

87 

Sever required 

88 

Purge in progress 


WEB Function Codes 

The tables in this section show the bits defined in field webfun, the function code 
for vscs. The function code depends on the value in webmode: 

• If webmode is 04, use “vm Function Codes for Internal States” on page 216. 

Internal function codes represent work functions within vscs. These are not 
considered to be inbound or outbound. 

• For all other webmodes: 

- For inbound, use “vm Function Codes for Inbound Processing in All Modes” 
on page 216. 

Inbound function codes represent work elements that are received by ccs. 

- For outbound, use the webmode: 

— If the webmode is 00, use "vm Function Codes for Outbound Processing 
in Console Mode” on page 217. 

— If the webmode is 01. use “vm Function Codes for Outbound Processing 
in CMS Mode” on page 217. 

— If the webmode is 02, use “vm Function Codes for Outbound Processing 
in Full-Screen Mode” on page 218. 

Outbound function codes represent work functions sent from ccs to vscs, or 
generated internally in vscs. The mode of the request (CMS, Console, or 
FSSM) determines which function is performed. 

Note: In this book, whenever a flow is referred to as inbound or outbound, you 
should take the Console Communications Services (ccs) as the reference point. 
That is, flows toward the ccs are inbound ; flows away from the ccs are outbound. 
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vm Function Codes for Internal States 


Name 

Hex Value 

Description 

WEBNTM10 

00 

Timer expired - ‘More’ 10 second, 
source = System Services 

WEBNVLFC 

01 

Logoff conditional, source = VTAM Services 

WEBNVLFU 

02 

Logoff unconditional, source = VTAM Services 

WEBINERR 

03 

Unrecoverable I/O error, logoff condition 

WEBINPUT 

04 

Attention identifier and optional data input 

WEBNVFLW 

05 

Logoff warning, source = VTAM Services 

WEBNSRSP 

06 

Input/output response (could be either normal or 
error), source = vtam Services 

WEBNVLGO 

07 

Logon response, source = VTAM Services 

WEBNACON 

08 

Accept connect, source = CCS 

WEBNSEVR 

09 

Sever connection, source = CCS 

WEBNMSGC 

0A 

IUCV one-way message complete, source = CCS 

WEBNTM50 

0B 

Timer expired - ‘More’ 50 second, 
source = System Services 

WEBNTNAL 

0D 

Timer expired - not accepted 3 second 

WEBNTF60 

0E 

Timer expired = FSSM 60 second, 
source = System Services 

WEBVSBRK 

OF 

Logoff request, source = Presentation Services 

WEBNVASY 

10 

Asynchronous error - WEBVSRPS indicates type 

WEBPSSRU 

10 

Send request, source = Presentation Services 

WEBNVCLU 

11 

Internal VTAM request cleanup, source = VTAM 
Services 

VVEBNSIML 

12 

Request to VTAM Services to issue SIMLOGON 

WEBNTCPY 

13 

PF key Copy wait for printer SIMLOGON timer 
expired 

WEBNTPRT 

14 

Timer expired for request to release printer after 
relreq exit driven 

WEBINOFC 

14 

Operator issued VSCS FORCE command — proc¬ 
essing continues in dtipforc 


vm Function Codes for Inbound Processing in All Modes 


Name 

Hex Value 

Description 

WEBINLOG 

01 

Logon request 

WEBINATT 

02 

Attention interrupt without data 

WEBINCB1 

05 

Move cursor back one 

WEBINLGF 

06 

VTAM-generated logoff condition, CCS logs user 
off 

WEBINFNU 

07 

FSSM request rejected, screen not in user mode 

WEBINAOK 

08 

Normal response 

WEBINACT 

09 

Accounting data for CCS 

WEBINOPC 

0A 

Operation check for FSSM request 

WEBINLER 

0B 

Logical interface error (DTIWEB) 

WEBINVER 

OC 

VSCS internal processing error 

WEBRDERR 

0D 

Error in input data found by the NCP 

WEBINVTM 

0E 

Identify VTAM user ID to CCS 
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vm Function Codes for Outbound Processing i 


Name 

Hex Value 

WEBCPWRT 

00 

WEBCPRED 

01 

WEBCPBRK 

02 

WEBCPWIC 

03 

WEBCPCPY 

04 

WEBCPIED 

05 

WEBCPFKR 

06 

WEBCPIDA 

07 

WEBCPINA 

08 

WEBCPREX 

09 

WEBCPTAB 

0A 

WEBCPLER 

0B 

WEBCPLOG 

OC 

WEBCPTMR 

0D 

WEBCPPTH 

0E 

WEBCPCAH 

OF 

WEBCPLSA 

10 


vm Function Codes for Outbound Processing i 

Name Hex Value 

WEBCMWRT 00 
WEBCMEWT 01 

WEBCMCLR 02 


Console Mode 

Description 

Write to next available line in output area 
Read request 

Break connection (CP logoff or disconnect) 

Write to input area and then position cursor as 
indicated in WEBCURSR 
Copy request 

Invalid environment definition 
PFK reply - treat as terminal input 
Data accepted, proceed with input processing 
Input not accepted 

IREPLY expected by way of synchronous 
PF key tab operation 

Logical interface error (WEB) (ISEND or reply) 
Logo 

Command end (no output for command entered) 
IUCV path ID 

Color and highlight map for advantage II 
Device information (terminal command) 

CMS Mode 

Description 

Write to line number specified in WEBLINE 
Erase output area and write to line number speci¬ 
fied in WEBLINE 

Erase entire screen and refresh the format of the 
output, input, and status areas 
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vm Function Codes for Outbound Processing in Full-Screen Mode 


Name Hex Value Description 


WEBFSWRT 

00 

FSSM 

WEBFSEWT 

01 

FSSM 

WEBFSEWA 

02 

FSSM 

WEBFSRDM 

03 

FSSM 

WEBFSRDB 

04 

FSSM 

WEBFSWSF 

05 

FSSM 

WEBFSEAU 

06 

FSSM 

WEBFSRBP 

07 

FSSM 

WEBFSRMP 

08 

FSSM 

WEBINCC1 

OF 

FSSM 

WEBINECU 

10 

FSSM 

WEBINDCU 

11 

FSSM 

WEBINEC 

12 

FSSM 

WEBINCRJ 

13 

FSSM 

WEBINDC 

14 

FSSM 

WEBINCC 

15 

FSSM 


write 

erase/write 

erase/write alternate 

read modified 

read buffer 

write structured field 

erase all unprotected 

read buffer by position 

read modified by position 

reflect attention, CC1 on SIO 

equipment check and unit specify 

data check and unit specify 

equipment check 

command reject 

data check 

control check 
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Chapter 7. Using VTAM Service Aids 

Many different service aids are available to help you collect information about sna 
network problems. This chapter describes when to use some of these aids and 
provides examples to help you interpret their output. 

Note: In addition to the service aids discussed in this chapter, you can use: 

• Chapter 6, “vm Using VSCS Service Aids" 

• Chapter 8, “Using the VTAM Internal Trace." 

This chapter discusses a number of service aids. Figure 35 on page 222 shows 
where in the network you can use these aids. 


Traces Provided by VTAM 

vtam provides several kinds of traces to record the flow of network events. Each 
trace occurs at a different point in the network (see Figure 35 on page 222). This 
difference allows you to narrow down the problem by following an ru through the 
network and determining where in the network the ru is incorrect. (The ru could 
be out of sequence or lost, the data in the ru could have been changed, and so 
forth.) 

The vtam traces and their results are: 

• The buffer contents trace shows the contents of inbound and outbound 
message buffers. 

• The i/o trace shows (in order) all i/o sent between vtam and a particular 
network node. 

• The sms (buffer use) trace shows information about the use of buffers, including 
how often a buffer pool has expanded, how many buffers are currently being 
used, and what was the maximum number of buffers used since the last trace 
record was written. 

• mvs The tget/tput trace shows each message as it passes between a tso 
command processor and tso/vtam. 

Notes: 

1. The vtam internal trace (vit) is discussed in Chapter 8, “Using the VTAM 
Internal Trace." 

2. The vscs trace facility (vm only) is discussed in Chapter 6, “vm Using VSCS 
Service Aids." 
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Figure 35. VTAM Traces 


Activating VTAM Traces 

You can activate vtam traces when vtam is started, or you can activate them only 
when they are needed. Use the trace option on the start command to begin the 
trace when vtam is started. Use the modify trace command to begin the trace 
when vtam is already running. The trace start option and the modify trace 
command have additional operands that are unique to the type of trace being 
started. For more information about using the trace start option, see VTAM Instal¬ 
lation and Resource Definition . For more information about using the modify trace 
command, see VTAM Operation. 

mvs vtam passes all trace data to the Generalized Trace Facility (gtf), which 
records all system trace data. Because of this, gtf must be active to use vtam 
traces. Specify trace = rnio for the vtam i/o trace. Specify trace-usr for all other 
vtam traces. 
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vm vtam and vscs pass all trace data to cptrap, using the gtrace macroinstruction. 
cptrap must be active with format type 3D active. In addition, an etrace command 
(with the gtrace and group operands) must be entered for the vtam and vscs 
virtual machine. For details, see “vm Using CPTRAP and TRAPRED” on page 225. 

vse vtam passes all trace data to the vtam trace file. 

Printing Trace Records 

Once the trace data is recorded, you can use one of the following facilities to print 
the traces: 

• Trace analysis program (tap) 

• MVS PRDMP 

• VM TRAPRED 

• VSE TPRINT. 

The following table indicates which traces can be formatted and printed by each of 
the formatting programs. In this table, ‘fp’ indicates that the trace is both formatted 
and printed; ‘up’ indicates that the trace is printed but not formatted. A blank entry 
indicates that the trace is neither formatted nor printed. 


Trace 

TAP 

PRDMP 

TRAPRED 

TPRINT 

Buffer contents trace 

FP 

FP 

FP 

FP 

Generalized PIU trace 

FP 




I/O trace 

FP 

FP 

FP 

FP 

Line trace 

FP 

FP 

FP 

FP 

Network controller line trace 

FP 




Scanner interface trace 

FP 




SMS (buffer use) trace 

- - 1 

UP 

FP 

FP 

FP 

TGET/TPUT trace 


UP 



Transmission group trace 

FP 

FP 

FP 

FP 

VSCS internal trace 


' 

FP 


VTAM internal trace 

UP 

FP 

FP 

FP 
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Using TAP 


You can format and print the following vtam traces (and only these traces) with the 
trace analysis program (tap) by setting the indicated option on the input operand: 


Specify: 

To format and print: 

LINE 

Line trace 

LINE 

Scanner interface trace (3720, 3725, and 3745 only) 

LINE 

Transmission group trace 

GPT 

Generalized piu trace 

RNIO 

i/o trace 

BUFFER 

Buffer contents trace 

NETCTLR 

Network controller line trace 


tap will print the sms (buffer use) trace, but not format it. tap also prints the vtam 
and vscs internal traces, unformatted, tap can print all internal trace entries, or 
you can select up to ten entry types. For more information on tap, see the NCP, 
SSP, and EP Diagnosis Guide. 


mvs Using PRDMP 

For the vtam i/o trace, set rnio on the edit option. For all other vtam traces, set 
usr = (symnuml[,symnum2]...[,symnum6] | all) on the edit option. 

symnum can be either a symbolic name or a number representing the trace that 
you want formatted and printed. If you specify usr = all, prdmp formats and prints 
all user and subsystem traces recorded by gtf (except for tget/tput trace, which is 
printed unformatted). Following are the valid symbols and numbers for the vtam 
traces: 


Symbol 

Number 

Trace 


INTI 

FE1 

vtam internal trace 


TPIO 

FEF 

vtam buffer contents trace 

— vtam (traced in tsc) 

CL01 

FF1 

vtam buffer contents trace 

— user (traced in api) 

CL02 

FFO 

sms (buffer use) trace 


LINE 

FF2 

ncp 3705 line or tg trace 


APTH 

FE2 

TSO/VTAM TGET/TPUT trace 



Note: The symbol and the number can be used interchangeably; for example, 
usr = (line) and usr = <ff 2 ) are the same. 

See the Service Aids manuals for your operating system for more information on 
prdmp and gtf. 
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mvs Fields in VTAM Trace Output 

In addition to the fields produced by vtam, the following MVS-only trace fields 
appear in vtam traces: 


Field Header 

Meaning 

ascb nnnnnnnri 

The address of the ascb for the address space that created the 
record. This field appears in a buffer contents trace, i/o trace, 
line trace, sms trace, or transmission group trace. 

cpu nnrm 

The id of the host processor in which the trace was run (applies 
only in a multiprocessor configuration). This field appears in an 
i/o trace. 

JOBN CCCCCCCC 

The name of the job associated with the i/o operation (for an i/o 
trace) or the address space (for a buffer contents, sms, line, or 
transmission group trace). 

RNIO 

The trace record was created by gtf (with trace = rnio). 

usrxx nnn 

The formatting routine (amdusrxx). vtam's trace formatter is 
amdusrfd. rwn is the event id that represents this trace. This 
field appears in a buffer contents trace, line trace, sms trace, or 
transmission group trace. 


vm Using CPTRAP and TRAPRED 

To collect vtam trace output in vm, issue the following commands from the vtam 
console. 

Note: To collect vscs trace output, see "vm How to Run External VSCS Traces” on 
page 161. 

In CP 

CPTRAP 3D 

CPTRAP GROUPID gcsgroup 

CPTRAP START TO userid userid is the receiver of the spool file 

In GCS 

ETRACE GTRACE GROUP 

In VTAM 

VTAM F TRACE,TYPE=type,ID=term_name 
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vtam will now start tracing to a spool file. When you have collected enough data 
and you want to stop tracing, issue the following commands: 

In CP 

CPTRAP STOP 


In GCS 

ETRACE GTRACE OFF 


In VTAM 

VTAM F NOTRACE,TYPE=type,ID=term_name 


At this point you will get a cp spool file in the reader of the user id specified in the 
cptrap start command. There are two ways to format the data, using trapred and 
using tap. tap is available only if you have installed ssp. To use trapred, issue the 
following commands: 


ACCESS 193 x 

TRAPRED fileno 

3D 


The gcs formatting routines are on this disk, “x” is a user- 
specified file mode. 

fileno is the spool reader file number. (Make sure the reader 
file is not in hold status.) 

Read vtam records only. 


FORMAT 


Format the records. 


PRINTER 999999 Print the records. (There are other commands that allow you 
to view the cptrap file online. See the VM/SP System Pro¬ 
grammer's Guide for vm R4, or the VM/SP Facility for System 
Programming for vm rs.) 


QUIT 

For more information on cptrap, see the VM/SP Operator's Guide . For more infor¬ 
mation on trapred, see the VM/SP System Programmer's Guide . (for vm R4) or the 
VM/SP Facility for System Programming (for vm rs). 

vm VM-Only Fields in VTAM Trace Output 

In addition to the fields produced by vtam, the following VM-only trace fields appear 
in vtam traces: 


Field Header 

Meaning 

Time-of-day 

clock 

Time when trace record was created. 

Length of gtf 
header and 

trace data 

Indicates the length of this trace record. 

Format routine 

ID 

Identifies formatting module used for this record. 
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VSE 


Field Header 

Meaning 

Event 

identification 

Information from gtrace macroinstruction's event id parameter. 


Using TPRINT 

The trace records generated by vtam traces are directed to a vtam trace file. Trace 
records in the trace file can then be printed by using the tprint utility program. 

The trace print utility runs as a subtask under vtam or as a job step under vse. To 
run the trace print utility as a subtask, the operator initiates printing with the modify 
subtask command while vtam is active. When the utility is run as a separate job 
step, printing can be done whether vtam is active or inactive. 

Job Step Procedure: The trace print utility can be executed through a job step pro¬ 
cedure that is defined when vtam is installed, syslst is assigned to a tape, printer, 
or disk, and the trace file is defined in dlbl and extent statements, for example: 

// DLBL TRFILE,'VTRACE',1,SD 

// EXTENT SYSQ04 

// ASSGN SYSQ04,132 

// ASSGN SYSLST,02E 


// EXEC TPRINT 

syslst must be assigned to a printer, tape, or disk with the name ijsysls. If it is not 
assigned, tprint is canceled. 

MODIFY SUBTASK Command: To start the trace print facility with the modify 
subtask command, use the id-tprint option. The operator is prompted to request 
a print of the trfile, using any of the print options available or a snapshot print. A 
snapshot prints all the 1 / 0 , buf, line, and tnstat records in vtam's main storage 1/0 
buffers, without accessing records previously written to trfile. (A snapshot print 
option is not available for the vtam internal trace.) When the contents of trfile are 
being printed, all tracing is suspended until the printout is completed. 

Note: When the trace print facility is run as a subtask, the trace output is not 
printed by vse until vtam is halted. 

For more detailed information about initiating the trace print facility and the options 
available, see VTAM Operation. 

All trace records contain either a time-stamp or a formatted time and date field 
from which the order of recording can be determined. This information can be 
helpful in synchronizing buffer contents and i/o traces and, to a lesser extent, vtam 
and non-VTAM traces. 
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The TPRINT User Exit Facility: An interface is provided in the trace print facility to 
allow the user to write an exit routine for the editing of vtam trace records. The 
dummy user exit module, istraeue, can be replaced by an installation-supplied 
module. The dummy module is called by the trace writing module, istracto, with 
the following register contents: 


Register 

Contents 

0 

0 = first entry to module 

1 = return for more output 

1 

Address of parameter list 

13 

Save area address 

14 

Caller's return address 

15 

istraeue entry point address 


The parameter list pointed to by register 1 contains the following information: 

• Word 1 address of trace record (isttrab) 

• Word 2 address of output buffer 

• Word 3 address of date and time stamp for this record 

Consider the following points when programming a user exit routine for the tprint 
facility: 

• tprint provides support for reading trfile with vse access methods dtfsd or 
dtfmt. The file format is standard variable blocked records with blksize = 2048. 
Each physical record contains a dummy 16-byte logical record that provides 
control information for tprint and is not passed to the user exit routine. The 
block header and the dummy record are mapped by the trb. 

• The remaining logical records contain trace data. Each has a 32-byte header 
mapped by the trab. Each is passed to the user exit routine for processing. 
Contents of the trab header and data format and length vary according to the 
trace record type. 

• tprint provides access method support for all syslst output. Line counting and 
page headers are provided automatically, dtfdi is used with asa control char¬ 
acters. The output buffer is cleared to blanks before the user exit routine is 
called. Use of control characters is limited to single space (), double space 
(0), triple space (•), and skip to channel 1 (1). When a skip is specified, tprint 
inserts its own page header and double space before printing the specified 
line. 

• The tprint user exit routine may provide its own access method interface to 
syslog (console) or any other device. For example: A trace record showing 
only errors is desired; or data reduction processing of trace records, such as 
line or internal trace, may require operator specification of additional record 
selection options. 

• Buffer, i/o, and tnstat records are single entry data records. Line and internal 
trace records contain one or more entries following the trab header. The user 
exit routine must perform all de-blocking logic for multiple-entry records, using 
return code 8 to request re-entry from tprint for additional processing of the 

____-same trace record. See Figure 36 on page 229 for an example of user exit 
routine logic. 
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Figure 37 on page 230 shows the format of trace records as recorded on the 
vtam trace file (trfile). 



Figure 36. vse TPRINT User Exit Routine Logic 
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Figure 37 (Parti of 2). vse Trace Records on TRFILE 
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Tuning statistics 


Line (CS 3) 


Hex 0 

RlEN 

0000 

4 

05 

000000 

8 

Time and date 
stamp 

10 


18 

Line name 

20 


24 


28 




2C 



J 


Legend 


(TNSTAT) 



4-byte 
data fields 


Flag bit 0 (direction): 1 = Inbound 
Flag bit 1:1= Confidential text 
ILRC = Inbound lost record count 
C_RC = Outbound iost record count 
RLEN = Total record length 


Figure 37 (Part 2 of 2). vse Trace Records on TRFILE 
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Buffer Contents Trace 

The buffer contents trace shows the contents of message buffers in two places: the 
application program interface (api) and the transmission subsystem component 
(tsc). When data is sent by an application program (outbound), api is the first com¬ 
ponent of vtam to process it, and tsc is the last component of vtam to process it. 
When data is received from the network (inbound), tsc is the first component of 
vtam to process it, and api is the last. To enable you to distinguish where in vtam 
the trace data was recorded, the output specifies either user (for data recorded in 
api) or vtam (for data recorded in tsc). 

The api writes user buffer contents trace records while user data is still in the 
application program's buffers, before it is copied into vtam buffers. Only user data 
is recorded. 

tsc writes vtam buffer contents trace records while the data is in vtam fixed I/O 
buffers. The entire piu — that is, the transmission header (th), request/response 
header (rh), and user data — is recorded. 

You can trace buffer contents data for messages to and from any of the following 
nodes: 

• Application program 

• Logical unit 

• Channel-attached 3270 

• sna cluster controller 

• ncp 

• sscp 

• Host physical unit 

• Cross-domain resource 

• Cross-domain resource manager. 

The trace record has a maximum length of 256 bytes, including trace field headers, 
transmission headers, request/response headers, and data. 

Note: vtam can start a buffer contents trace only for the resources that it owns. A 
data host, which does not own any ncps, cannot start a buffer contents trace for an 
ncp or any of the ncp's subordinate resources. 

When to Use the Buffer Contents Trace 

The buffer contents trace can help you determine whether a problem is in the host 
(vtam or an application program) or in the network. For example, if an application 
program sends a message to a terminal, and the message is correct in vtam buffer 
contents trace output, but the message does not appear correctly at the terminal, 
then the problem is probably in a system resource other than vtam or the applica¬ 
tion program. 

The buffer contents trace cannot always be used to distinguish an application 
program problem from a vtam problem. However, it can confirm the order in which 
data is passed between an application program and a logical unit. It can also 
record all the data passing to and from an application program. 

If you do not need to trace user data, use the i/o trace. 
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Buffer Contents Trace Operation 

Start the buffer contents trace with the modify trace command or the trace start 
option. 


Specify: To Trace: 


id = nodename Requests and responses flowing between vtam and nodename. 


ID = VTAM 


Request and response units (rus) for sscp sessions. 


Request and response units (rus) for sessions between the host 
physical unit and another physical unit type 5 or a physical unit 
type 4 (these rus include er-act, er-op, and er-test rus). 


If you use the scope = all or every operand when you start the trace, vtam records 
messages to and from the specified node and all its valid subnodes. 

Note: You cannot use the scope = all or every operands with id=istpus. 

For more information on the modify trace command, see VTAM Operation. For 
more information on the trace start option, see VTAM Installation and Resource 
Definition. 

mvs Make sure that gtf (with trace = usr) is active before starting this trace. To 
format and print the data recorded by gtf, use prdmp and set usr = (TPIO.cloi) or 
usr-(FEF.ffi) on the edit option. 


Specify: 

To Cause PRDMP to: 

FF1 

Format and print the buffer data recorded in the api component 
of vtam. The trace output says "user". 

FEF 

Format and print the buffer data recorded in the tsc component 
of vtam. The trace output says "vtam". 


vm Use cptrap (with a format id of 3D) to collect buffer contents trace data. Enter 
the etrace command, using the gtrace and group operands. Use trapred or tap to 
format and print the output. 

vse Use tprint to print the buffer contents trace records. 

For more information on printing trace output, see "Printing Trace Records" on 
page 223. 

Buffer Contents Trace Output 

Figure 38 on page 234 shows an example of buffer contents trace output in mvs. 
(The output for vm and vse are similar.) 

The trace fields are explained after the figure. In addition to the fields described 
here, additional operating-system — dependent fields may appear (in mvs and vm). 
For a description of these fields, see "mvs Fields in VTAM Trace Output" on 
page 225 and "vm VM-Only Fields in VTAM Trace Output" on page 226. 
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BUFF 

VTAM 


APPL12 /TERM200 LRC(000,000) INBOUND 
TH=40000000 200000C2 0000 000C 00000004 
7DD8E811 D7F1F3C8 C1E3C140 C9E240C3 
D6D4D4C9 D5C740C9 D540D6D5 40E4E2C5 


IC00Q005 0028004 0040 RH=030080 
*'QY.P1THIS DATA IS C* 
*0MMING IN ON THE USE* 


BUFF APPL12 /TERM200 LRC(000,000) OUTBOUND 
USER C5D5E3D9 40C4C1E3 C140E3D6 40C5C8D6 
C5D3D6E6 4B5CF04B D7D9C5E2 E240C5D5 


*ENTER DATA TO ECHO B* 
*EL0W.*0.PRESS ENTER * 


Figure 38. Example of Buffer Contents Trace Output 


The following fields appear in the buffer contents trace: 


Field Header 

Meaning 

buf destname/origname 

Is the destination (destname) and origin ( origname ) 
node name. In Figure 38 the destination is appli 2 and 
the origin is TERM 200 . 

LRC(xxx,yyy) 

The number of records lost since the last trace record 
was written because the trace facility could not get a 
vtam buffer, xxx is the destination's lost record count, 
and yyy is the source's lost record count. 

inbound or outbound 

The direction of the traced data (inbound or outbound) 
with respect to this host subarea. By use of this field 
and the piu sequence number in the th, requests and 
corresponding responses can be matched. 

vtam or USER 

Indicates where the message buffers were traced. 
vtam means the buffers were traced in tsc (in which 
case the th and the rh are included in the trace 
record), user means the buffers were traced in api (in 
which case the th and the rh are not included). 

TH 

The 26-byte transmission header portion of the path 
information unit (piu). 

RH 

The 3-byte request/response header portion of the piu. 


The rest of the trace record shows the contents of the buffer. Each line contains 20 
bytes of user data in five groups of eight hexadecimal digits followed by the equiv¬ 
alent 20 ebcdic characters. 

Confidential data will not be recorded in trace records. When the trace facility 
detects confidential data (conftxt-yes is specified on the applications program's 
nib macroinstruction), the user data is replaced with the marker in the trace output. 

mvs vm The marker is ‘confidential and suppressed’, 
vse The marker is ‘confidential data’. 

mvs If you are using the vtam encryption facility, data on a cryptographic session is 
handled in the same way as confidential data. 
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I/O Trace 

The i/o trace shows requests and responses that flow between vtam and network 
nodes. You can trace i/o activity for any of the following types of nodes: 

• Application program 

• Physical unit 

• Logical unit 

• sna cluster controller 

• NCP 

• SSCP 

• Host physical unit 

• Host as an intermediate routing node 

• Channel attachment major node 

• Cross-domain resource 

• Cross-domain resource manager. 

The maximum i/o trace record length is 36 bytes. 

When to Use the I/O Trace 

Use the i/o trace to record the order that Pius flow between network nodes and 
vtam. For example, you might use this trace to determine whether an application 
program receives all the responses that it should and whether vtam forwards all 
the requests issued by the application program. 

The content of the i/o trace is similar to that of the buffer trace, except that the i/o 
trace records less user data. If you do not need this user data, you can save trace 
file space by using the i/o trace. 


I/O Trace Operation 

Start the i/o trace with the modify trace command or the trace start option. 


Specify: To Trace: 


id = nodename 

id=VTAM 
ID = ISTPUS 


ID = ISTIRN 


Requests and responses flowing between vtam and nodename. 

Request and response units (rus) for SSCP sessions. 

Request and response units (rus) for sessions between the host 
physical unit and another physical unit type 5 or a physical unit 
type 4 (these rus include er-act, er-op, and er-testrus). 

Request and response units (rus) that flow through this host 
while this host is acting as an intermediate routing node. 


If you use the scope=all or every operand when you start the trace, the trace 
records i/o activity for the specified node and all its valid subnodes. 

Notes: 

1. You cannot use the scope=all or every operands with id=istpus omd=istirn. 

2. You must specify scope=all when tracing a channel-attachment major node. 

3. You may trace a link in a channel-attachment major node, but not a link station. 

See VTAM Operation for information on the modify command. See VTAM Installa¬ 
tion and Resource Definition for more information on the trace start option. 
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mvs Make sure that gtf (with trace = rnio) is active before starting this trace. To 
format and print the data recorded by gtf, use either prdmp or tap. For prdmp, set 
rnio on the edit option. 

vm Use cptrap (with a format id of 3D) to collect i/o trace data. Enter the etrace 
command, using the gtrace and group operands. Use trapred or tap to format and 
print the output. 

vse Use tprint or tap to print the trace records collected by the i/o trace. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


I/O Trace Output 

mvs vm Figure 39 shows an example of i/o trace output. 
vse Figure 40 shows an example of i/o trace output. 

The trace fields are explained after each figure. In addition to the fields described 
here, additional operating system dependent fields may appear (in mvs and vm). 
For a description of these fields, see 1 mvs Fields in VTAM Trace Output” on 
page 225 and “vm VM-Only Fields in VTAM Trace Output” on page 226. 


IN 40000000 200080B1 OOOOOOOC 00000004 0E000005 
OUT 42000000 2000009A 00000004 OOOOOOOC 0E00000B 


0OOB8O8D 000A9B80 00000841 00006000 
0005808D 000ACB80 00000823 00000000 


Figure 39. mvs vm Example of I/O Trace Output 
mvs vm The following fields appear in the i/o trace: 


Field Header 

Meaning 

in or out 

The direction of the trace record: in for inbound to vtam, and out 
for outbound to the specified node. When istirn is specified, 
each ru is traced twice — once when it enters vtam (in) and once 
when it leaves (out). 


The rest of the trace record is some or all the path information unit (piu). It consists 
of a 26-byte transmission header (th), a request/response header (rh), and as 
much of the request/response unit (ru) as will fit. The data length field in the th 
indicates the length of the rh and ru in bytes. The ru may contain sense data. 


10 TERM12 / 37.153/10:31:02.13 OUTBOUND 

TH=40000000000000000000000COOOOOOOC1D0000390005000D0028 RH=6B8000 RU=31010202714020 

10 /TERM12 67.153/10:31:02.15 INBOUND 

TH=40000000000000000000000COOOOOOOC1D0000050039000D0004 RH=EB8000 RU=31 

Figure 40. VSE Example of I/O Trace Output 
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vse The following fields appear in the i/o trace: 


Field Header 

Meaning 

io destnamelorigname 

Is the destination (destname) or origin ( origname ) 
node name. Usually, only one node name will be 
resolved by the i/o trace. In Figure 40 on page 236 
the node name is termi2 in both records. 

yy.jjj/hh:mm:ss.hh 

Is the year (yy), the Julian date (jjj), and the time to 
hundredths of a second (hh:mm:ss.hh) that trace 
record was written. 

To find this field in Figure 40 on page 236, look for 
"87.153/10:31:02.13" in the first trace record. 

LRC(xxx.yyy) 

Is the number of records lost since the last trace 
record was written because of the inability of the 
trace facility to get vtam buffers, xxx is the destina¬ 
tion's lost record count, and yyy is the source's lost 
record count. This field is not present in the trace 
record unless records are lost. 

INBOUND or OUTBOUND 

The direction of the traced data (inbound or outbound) 
with respect to this host subarea. With this field and 
the piu sequence number in theTH, requests and cor¬ 
responding responses can be matched. 

TH 

Is the 26-byte transmission header portion of the path 
information unit (piu). The data length field in the th 
indicates the length of the rh and ru in bytes. 

RH 

Is the 3-byte request/response header portion of the 
PIU. 

RU 

Ten bytes of the request/response unit, which may 
contain sense data. 


SMS (Buffer Use) Trace 

The storage management services (sms) trace records contain information on the 
use and availability of vtam buffer pools, sms trace records are written after a pre¬ 
determined number of requests occur for vtam buffers. An IBM-supplied threshold 
causes a trace record to be written after every 1000 (hex 3E8) requests. 

To change the IBM-supplied number (the halfword at label racbsnap in vtam module 
istracon), use the service aid spzap (in mvs and vm) or the utility aid mshp (in vse). 

mvs See MVS Service Aids for a complete description of spzap. 

vm See the VM/SP Group Control System Guide for a complete description of 
spzap. 

vse See the VSE/AF MSHP Reference for a complete description of mshp. 
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Notes: 

1. If the display bfruse command is issued while this trace is running, the fields 
max total, max used, and times exp reflects buffer usage only since the last 
trace record was written, because the sms trace resets these fields. 

2. The sms trace is not the same thing as the vtam internal trace with the sms 
option specified. The sms trace Is similar to the display bfruse command. The 
sms trace displays in trace output the same information that the display bfruse 
command displays on the screen. 

When to Use the SMS Trace 

Use the sms trace during vtam installation to evaluate vtam use of buffer pools, to 
help estimate how many buffers vtam needs for normal operation, and, with 
dynamic buffering, to limit buffer pool expansions to peak use periods. You can 
use the sms trace in conjunction with tuning statistics. 

SMS Trace Operation 

Start the sms trace with the modify trace command, or use the trace start option 
with type = sms and id = vtambuf specified. For more information about the modify 
trace command, see VTAM Operation. For more information about the trace start 
option, see VTAM Installation and Resource Definition. 

mvs Make sure that gtf (with trace = usr) is active before starting this trace. To 
format and print the data recorded by gtf, use prdmp and set usr = (ffo) or 
usr = (CL02) on the edit option. 

vm Use cptrap (with a format id of 3D) to collect sms (buffer use) trace data. Enter 
the etrace command, using the gtrace and group operands. Use trapred or tap to 
format and print the output. 

vse Make sure that sdaid is active, and trace vtambu is specified. The trace output 
can be printed with the dosvsdmp utility program. For more information on sdaid 
and dosvsdmp, see VSE Service Aids. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 

nvs vm SMS Trace Record Output 

The sms trace record format is the same for mvs and vm. Figure 41 and Figure 42 
on page 239 show examples of sms trace output. 


The trace fields are explained after the figures. In addition to the fields described 
here, other operating-system-dependent fields may appear. These fields are 
described in “mvs Fields in VTAM Trace Output” on page 225 and “vm VM-Only 
Fields in VTAM Trace Output” on page 226. 


VTAM BUFFERS MAXU 
10 0021 
LP 0004 
CR 0001 
SF 0002 


MAXQ AVN0 TEXP MBUF T0TL 
0000 0044 0000 0064 0064 PP 
0000 003E 0000 0040 0040 WP 
0000 0000 0000 0021 0021 UE 
0000 0021 0000 0033 0033 SP 


MAXU MAXQ 
0000 0000 
0001 0000 
0000 0000 
0000 0000 


AVN0 TEXP 
0000 0000 
0Q1B 0000 
0022 0000 
0000 0000 


MBUF T0TL 
0000 0000 
0010 0010 
0022 0022 
0000 0000 


Figure 41. mvs vm Example of SMS Trace Output for VTAM Pre-V3R2 
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VTAM BUFFERS 


MAXU 

10 00000021 
PP 00000000 
LP 00000004 
WP 00000001 
NP 00000000 
LF 00000000 


MAXQ 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 


AVNO 

00000044 

00000000 

0000003E 

0000001B 

00000000 

00000000 


TEXP 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 


MBUF 

00000064 

00000000 

00000040 

00000010 

00000000 

00000000 


TOTL 

00000064 

00000000 

00000040 

00000010 

00000000 

00000000 


VTAM BUFFERS 


MAXU MAXQ 
CR 00000001 00000000 
UE 00000000 00000000 
SF 00000002 00000000 
SP 00000000 00000000 
AP 00000000 00000000 


AVNO 

00000000 

00000022 

00000021 

00000000 

00000000 


TEXP 

00000000 

00000000 

00000000 

00000000 

00000000 


MBUF 

00000021 

00000022 

00000033 

00000000 

00000000 


TOTL 

00000021 

00000022 

00000033 

00000000 

00000000 


Figure 42. mvs VM Example of SMS Trace Output for VTAM V3R2. Two separate records 
will be printed, and they may be separated by another trace entry. 


The following fields appear in the sms trace for mvs and vm: 


Field Header 

Meaning 

Pool ID 

Is the first field in each record and identifies the buffer pool. 

Pool ids and their corresponding buffer pool names are: 

ap Application program pageable pool (apbuf) 

cr Copied rpl pool (crplbuf) 

io Fixed i/o pool (iobuf) 

lf Large fixed pool (lfbuf) 

lp Large pageable pool (lpbuf) 

sf Small fixed pool (sfbuf) 

sp Small pageable pool (spbuf) 

wp Working set pageable pool (wpbuf). 

Note: npbuf, ppbuf, and upbuf are no longer used by vtam. 

MAXU 

The maximum number of buffers in the pool that were in use at 
any time since the last trace record was written. 

MAXQ 

The maximum number of requests for buffers that were queued 
waiting for storage at any time since the last trace record was 
written. 

AVNO 

The number of available buffers (those not in use at the time the 
trace record was written). 

TEXP 

The number of times the buffer pool was expanded since the last 
trace record was written. 

MBUF 

The maximum number of buffers that were in the pool at any 
time since the last trace record was written. This includes both 
used and unused buffers. 

TOTL 

The total number of buffers that were in the pool at the time this 
record was written. This includes both used and unused buffers. 
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vse SMS Trace Record Output 

Figure 43 shows an example of sms trace output for vse. The trace fields are 
explained after the figure. 


VTAM BUFFER POOL USE SEQ. NO = 
VF IN USE=0QO11 MAX AL10C=00011 
VP IN USE=00397 MAX ALL0C=00424 
SF IN USE=00009 MAX ALLOC=00011 
LF IN USE=00045 MAX ALL0C=00109 
SP IN USE=00000 MAX ALL0C=00001 
LP IN USE=00005 MAX ALL0C=00011 
WP IN USE=0Q079 MAX ALL0C=00G87 


00000001 DAY 223 TIME 08:21:43 
MAX WAIT=00000 EXPAND=00000 MAX AVAIL=00000 
MAX WAIT=00000 EXPAND=00000 MAX AVAIL=00000 
MAX WAIT=0G000 EXPAND=00000 MAX AVAI1=00022 
MAX WAIT=0GGG0 EXPAND=00027 MAX AVAIL=00116 
MAX WAIT=OGO0O EXPAN0=00Q00 MAX AVAIL=00022 
MAX WAIT=00000 EXPAND=00003 MAX AVAIL=0G015 
MAX WAIT=00000 EXPAND=OOO03 MAX AVAIL=00099 


CUR AVAIL=00000 
CUR AVAIL=00000 
CUR AVAIL=00002 
CUR AVAIL=00063 
CUR AVAIL=00003 
CUR AVAIL=00009 
CUR AVAIL=O0O27 


Figure 43. VSE Example of SMS Trace Output 


The following fields appear in the sms trace for vse: 


Field Header 

Pool ID 


IN USE 


MAX ALLOC 


MAX WAIT 


EXPAND 


Meaning 

Is the first field in each record. It identifies the buffer pool. Pool 
ids and their corresponding buffer pool names are: 


LF 

Large fixed pool (lfbuf) 

LP 

Large pageable pool (lpbuf) 

SF 

Small fixed pool (sfbuf) 

SP 

Small pageable pool (spbuf) 

VF 

Variable fixed pool (vfbuf) 

VP 

Variable pageable pool (vpbuf) 

WP 

Notes: 

Working set pageable pool (wpbuf). 


1. Sometimes pool names are not listed. The pool names are 
not available when vtam is running disabled. 

2. apbuf, npbuf, ppbuf, and upbuf are no longer used by vtam. 

Indicates the number of buffers in the pool that were in use at 
any time during the time covered by the snapshot dump. For the 
vp and vf pools it indicates the number of pages that were in use 
at the time the snapshot dump was taken. 

Indicates the maximum number of buffers in the pool that were 
in use at any time during the time covered by the snapshot 
dump. For the vp and vf pools it indicates the maximum number 
of pages in use. 

Indicates the maximum number of requests for buffers that were 
queued waiting for storage at any time during the time covered 
by the snapshot dump. For vf and vp pools this field has no 
meaning. 

Indicates the number of times the buffer pool was expanded 
during the time covered by the snapshot dump. For vf and vp 
pools this field has no meaning. 
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Field Header 

Meaning 

MAX AVAIL 

Indicates the maximum number of buffers that were in the pool 
at any time during the time covered by the snapshot dump. For 
vf and vp pools this field has no meaning. 

CUR AVAIL 

Indicates the number of buffers that were in the pool at the time 
the snapshot dump was taken. For vf and vp pools this field has 
no meaning. 


mvs TGET/TPUT Trace for TS0/VTAM 

The tget/tput trace for tso/vtam writes a gtf trace record for each inbound and out¬ 
bound message that uses the tget/tput/tpg interface (SVC93) between aTSO 
command processor and the vtioc component of tso/vtam. Outbound messages 
are traced before being placed in the vtioc queue manager output buffer. Inbound 
messages are traced before the data is sent to the tso command processor. 

Note: The tget/tput trace does not trace address space idtputs. 

mvs When to Use the TGET/TPUT Trace 

Use this trace if the failure is restricted to tso sessions. This trace can help you 
determine whether tso/vtam or your tso command processor is causing the 
problem. For example, if outbound data is correct in the tget/tput trace output, but 
incorrect in the buffer trace output, the problem is probably in tso/vtam or vtam. 

Use the following tables as a guideline to determine where the error is occurring: 


Direction 

of Data 

If TPUT 

Trace Data Is: 

And Buffer or I/O 
Trace Data Is: 

Then Possible 

Error Is In: 

Outbound 

Correct 

Incorrect 

• VTAM 

• TSO/VTAM 

• TPUT option 

• User edit 

exits 

Outbound 

Incorrect 

Trace not 
required 

TSO or the 

command 

processor 

Outbound 

Correct 

Correct 

Network 


Figure 44. mvs Location of TPUT (Outbound) Error 
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Direction 
of Data 

If TGET 

Trace Data Is: 

And Buffer or I/O 
Trace Data Is: 

Then Possible 

Error Is In: 

Inbound 

Incorrect 

Correct 

• VTAM 

• TSO/VTAM 

• TGET option 

• User edit 

exits 

Inbound 

Correct 

Trace not 
required 

TSO or the 

command 

processor 

Inbound 

Incorrect 

Incorrect 

Network 


Figure 45. MVS Location of TGET (Inbound) Error 


MVS TGET/TPUT Trace Operation 

Start the tget/tput trace with the modify trace command and specify type-tso. 

The trace output is a record of inbound and outbound messages for the specified 
tso user id. 

Make sure that gtf (with trace = usr) is active before starting this trace. To print 
these trace records, use prdmp with user = (fe2) specified. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 

MVS TGET/TPUT Trace Output 

The trace records created by the tget/tput trace have a 12-byte gtf header and a 
32-byte trace header followed by the data portion of the ru in unformatted 
hexadecimal. The entire ru is traced, but will span several trace entries if it is 
longer than 228 bytes. 

Figure 46 on page 243 shows an example of tget/tput trace output. The trace 
fields are explained after the figure. 
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TIME 26261.617577 

HEXFORMAT AID FF FID 00 EID EFE2 0000 00FED640 C5D9D5C9 C5404040 E3E2D6D6 
TIME 26261.618125 0018 C5D9D5C9 C5404040 D3F3C5F1 40404040 

0030 40E6C9E3 C81D60F2 F411C7D6 40404040 
0048 403C4F5F 403CD35E 403CD75D 403C5B5C 
0060 13 


TIME 26261.618125 

HEXFORMAT AID FF FID 00 EID EFE2I0000 
TIME 26265.370315 |0018 

' 0030 

TIME 26265.370315 ' 


00FED640 [C5D9D5C9 C5404040 E3E2D6C9 
C5D9D5C9 ^404040 [D3F3C5F1 40404040 
~Te4 F3 


-** DATE DAY 094 


YEAR 1985 


TIME 


HEXFORMAT A ID FF FID 00 E ID EFEj 
TIME 26265.487905 


0000 00FED640 
0018| C3D9D5C9 
4C40D7D9 
C5JC6C9D5 


E840D7 

| r 2F7F8 


C6I 
F3 

40D2C5E8 
C0A& D3D73CC4 
COci C540401D 
00D$ F44011C5 
01D60 


00F0 C69I 
01013 C7C! 


I51D60 


Hex 

Offset 


ASCB TSO 
User 
ID 


2.17.45.356064 


C5D9D5C9 
('5404040 
D6C7D9C1 
PE3C9D6 
1D9C1D4 
40E3C5D9 
E27A11C3 
E5401D60 
30D7C6F2 
51D60D7 
t)7C6F340 


C5404040 
[J3F3C5F1 
D440C6E4 
[>540401 1 
C5E3C5D9 
D4C9D5C1 
F01D60D7 
D7C6F1F3 
-►010E87E 
$6F 1 F41D 
DE87E7E 


E3E2D6D6 
40404040 
D5C3E3C9 
C1D1C5D5 
E240C2C5 
D340E6C9 
C6F1401D 
1DE87E7E 
7E6E1DC8 
E87E7E6E 
6E1DC8C5 


Job 

Name 


Terminal 

ID 


E4E30300 D3C1E2E3 *..0 ERNIE TSOOUT..LAST * 

00000000 C9D5C1D3 *ERNIE L3E1 _INAL* 

11C7601D 60304B60 * WITH..24.GO .G.* 

403C4040 4011C1E4 * ... .L. .P.AU* 


D5406100 D3C1E2E3 *..0 ERNIE TS01N ..LAST* 

00000000 7DC1E511 -ERNIE L3E1 .AV.* 

! *AU3 


* * * 


E4E30300 
00000000 
D6D540D2 
E3C50961 
D3D6E640 
E3C840F2 
E87E7E6E 
6E1D08C8 
E2D7D3C9 
1DC8E2D7 
D5C4403C 


Flags 


C9D5C9E3 *..0 ERNIE TSOOUT..IN IT* 

C11140D4 *ERNIE L3E1 _A. M* 

C5E840C4 * PROGRAM FUNCTION KEY D* 
E5C5D9C9 DEFINITION .AJENTER.VERI * 
C6D6D940 *FY PARAMETERS BELOW FOR • 
F440D7C6 *3278 TERMINAL WITH 24 PF* 

1DC8C8C5 -KEYS..CO..PF1 .Y_HHE* 

C5D3D73C *LP.DV ..PF13.Y_HHELP.* 

E34C3CC5 *E ..PF2 .Y_HSPLIT .E* 

D3C9E311 -F...PF3 .Y_HEND .GD 

C7C44011 *GE.. 


Figure 46. MVS Example of TGET/TPUT Trace Output 
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The following fields appear in the tget/tput trace. 

The first two bytes in each row show the hex offset in storage. The data follows 
after that. 


Byte 

(hex) Meaning 

00-03 ascb address 
04-OB Job name 
0C-0E C'tso’ 

OF- 11 C'in* for inbound data (tget); C'out’ for outbound data (tput) 

12 tget/tput option flags (see the svc 93 description in the Debugging Hand¬ 
book for bit definitions) 

13 tget: return code (see the TSO Guide to Writing a Terminal Monitor 
Program for descriptions) 

tput: 

X'00’ EDIT, ASID, FULLSCREEN, Or CONTROL options. 

X'01' NOEDIT option 
X 1 02 1 tpg macro issued 

14-17 C'init' for the first 228-byte section of a piu; C'mid’ for the middle sections 
of a piu; C'last’ for the last section of a piu 

18-IF tso user id 

20-27 Symbolic terminal id 

28-2B Zero 


2C Start of user data. 
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Traces Provided by NCP 

ncp provides several kinds of traces to record the flow of network events. Each 
trace occurs at a different point in the network (see Figure 35 on page 222). This 
allows you to follow an ru through the network and determine where in the network 
the ru is incorrect. (The ru could be out of sequence or lost, the data in the ru 
could have been changed, and so forth.) 

The ncp traces are: 

• “Generalized PIU Trace” 

• “Line Trace” on page 246 

• “mvs Network Controller Line Trace (3710 Only)” on page 250 

• “Scanner Interface Trace (3720, 3725, and 3745 Only)” on page 251 

• “Transmission Group Trace” on page 252. 

For more information on all service aids for ncp, see the NCP, SSP, and EP Diag¬ 
nosis Guide. 


Generalized PIU Trace 

The generalized piu trace collects piu trace data collected by the ncp. The resulting 
trace output shows the flow of Pius exchanged between the ncp and its attached 
resources. This trace is hierarchical when started for a physical unit or a line. 

That is, logical units associated with the physical unit are automatically traced 
when traffic flows to them. Likewise, when the generalized piu trace is started for a 
line, physical units and logical units associated with the line are automatically 
traced when traffic flows to them. When the generalized piu trace is stopped for a 
physical unit, the trace is reset for all logical units associated with the physical 
unit, regardless of how the generalized piu trace was started. 

When to Use the Generalized PIU Trace 

Use the generalized piu trace to trace piu data at the ncp level and to determine 
whether the ncp has received or sent piu data. 

Note: vtam can start a generalized piu trace only for the resources that it owns. A 
data host, which does not own any ncps, cannot start a generalized piu trace for an 
ncp or any of the ncp's subordinate resources. 

Generalized PIU Trace Operation 

Start the generalized piu trace with the modify trace command. For more informa¬ 
tion on the modify trace command for the generalized piu trace, see VTAM Opera¬ 
tion. 

mvs Make sure that gtf (with trace = usr) is active before starting this trace. Use 
tap with input = gpt to format and print the trace output. 

vm Use cptrap (with a format id of 3D) to collect generalized piu trace data. Enter 
the etrace command, using the gtrace and group operands. Use trapred or tap to 
format and print the output. 

vse Use tap with input-gpt to format and print the trace output. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 
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Line Trace 

The line trace, a joint function of vtam and the ncp, records the status of a line each 
time the ncp receives data from or sends data to that line. Although the trace is 
controlled by vtam, the information in the trace records is collected by the ncp. The 
ncp sends the data to vtam in a piu. A trace type indicator in the piu indicates 
whether the trace is a byte line trace (Type 2 scanner) or a block line trace (Type 3 
scanner). 

The line trace records the operating parameters of a line each time a level 2 inter¬ 
ruption occurs on that line. 

• For a 3705 Communications Controller with a Type 2 communication scanner, a 
level 2 interruption occurs each time a byte of data is sent or received across 
the line. 

• For a 3705 Communications Controller with a Type 3 communication scanner, a 
level 2 interruption occurs each time an ncp buffer is filled and the buffer data 
is sent or received across the line. 

• For a 3720, 3725, or 3745 Communication Controller, a level 2 interruption 
occurs each time a message (an entire piu) is sent or received. 

You can use the line trace only for lines attached to a communication controller 
and operating in network control mode. 

For each 3705 Communications Controller, as many as eight line traces can be 
active at a time. 

For each 3720, 3725, or 3745 Communication Controller, a combination of eight line 
or scanner interface traces can be active at one time. 

The number of active line traces to be allowed is specified during ncp generation. 

In a cross-domain network in which the communication controller is connected to 
more than one host processor, the number of active traces allowed is distributed 
among the connected host processors on a first-come, first-served basis. 

Note: As the number of active line traces increases, the system becomes less effi¬ 
cient. 

When to Use the Line Trace 

You might use this trace if you suspect a problem with a device attached to a com¬ 
munication controller. If data appears correctly in the line trace but the terminal or 
printer does not react appropriately, the device itself is probably causing the 
failure. 

Before using a line trace, you should use buffer and i/o traces to verify that the 
problem is not in vtam or an application program. You may also want to use the 
scanner interface trace (for 3720, 3725, and 3745 Communication Controllers only), 
which traces data after it has been processed by the ncp and before it leaves the 
communication controller. Therefore, it can help determine whether the problem is 
in the ncp or in the line. 

Note: vtam can start a line trace only for the resources that it owns. A data host, 
which does not own any ncps, cannot start a line trace for an ncp or any of the 
ncp's subordinate resources. 
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You might want to use a transmission group (tg) trace instead of or in addition to 
this trace. If there is more than one active line in a transmission group, and you do 
not know which line is causing the problem, use the transmission group trace. The 
transmission group trace also shows more data than the line trace. 

Line Trace Operation 

Start the line trace with the modify trace command or the trace start option. In 
either case, specify type = line. For more information on the modify trace 
command, see VTAM Operation. For more information on the trace start option, 
see VTAM Installation and Resource Definition. 

mvs Make sure that gtf (with trace = usr) is active before starting this trace. To 
format and print the line trace: 

• For a 3705, use tap or prdmp. For prdmp, specify usr = (line) or usr = (FF2) on the 
edit option. 

• For a 3720, 3725, or 3745, use tap with input = line specified. 

vm Use trapred or tap to format and print the output. 

• For a 3705, use tap or trapred. For trapred, specify the EFF2 option. 

• For a 3720, 3725, or 3745, use tap with input = line specified. 

vse Use tprint or tap to format and print the line trace. 

• For a 3705, use tap or tprint. For tprint, specify line = name or line = all. 

• For a 3720, 3725, or 3745, use tap with input = line specified. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 

Line Trace Output (CS Type 2) 

Figure 47 shows an example of line trace output for a 3705 Communications Con¬ 
troller with a Type 2 communication scanner. This example was created with 
prdmp, the mvs print utility, but the output looks the same for vm and vse, except as 
noted below. 

The trace fields are explained after the figure. In addition to the fields described 
here, additional operating-system-dependent fields may appear (in mvs and vm). 

For a description of these fields, see “mvs Fields in VTAM Trace Output” on 
page 225 and “vm VM-Only Fields in VTAM Trace Output" on page 226. 


LINE 1 

LINE01 

LRC(0OO,0OO) 

INBOUND 

ACTIVE RNTIME= 

ID 







LCD 

C 

PCF 

A 

TIME 

16 SCF 

42 

PDF 

D4 

LCD 

C 

PCF 

A 

TIME 

16 

SCF 

42 

PDF 

40 

LCD 

C 

PCF 

A 

TIME 

16 SCF 

42 

PDF 

E5 

LCD 

C 

PCF 

A 

TIME 

16 

SCF 

42 

PDF 

40 

LCD 

C 

PCF 

A 

TIME 

16 SCF 

42 

PDF 

E3 

LCD 

C 

PCF 

A 

TIME 

16 

SCF 

42 

PDF 

40 

LCD 

C 

PCF 

A 

TIME 

16 SCF 

42 

PDF 

Cl 

LCD 

C 

PCF 

A 

TIME 

16 

SCF 

42 

PDF 

40 


Figure 47. Example of Line Trace Output (CS Type 2) 


The following fields appear in the line trace for cs Type 2. 
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The header portion of the line trace record contains these fields: 


Field Header 

Field Contents 

LINE 

The name of the node being traced. In Figure 47, the line name 

is LINE01. 

LRC(xxx.yyy) 

The number of records lost since the last trace record was 
written because the trace facility could not get a vtam buffer, 
xxx is the destination's lost record count, and yyy is the source's 
lost record count. 

INBOUND 

mvs vm The direction of the data with respect to this host. It 
always says inbound because vtam always receives the trace 
records from the ncp. 

vse This field is replaced by a time stamp. 

ACTIVE 

The status of the line being traced. In Figure 47, the line status 
is active. The line status may also appear as deactivate or 

SLOWDOWN. 

• active means that the line trace is active. 

• deactivate means that the line trace is not active. 

• slowdown means that the line trace is not active because the 
ncp is in slowdown mode. 

A status of deactivate or slowdown appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 

RNTIME = hh 

Is a timer field, hh is a hexadecimal value indicating in tenths of 
a second the time at which the communication controller sent 
the completed line trace record to vtam. This value is taken 
from a timer that is reset to 0 after 25.5 seconds. This value can 
be compared with the time value for the first level 2 interruption 
data contained in the second part of the line trace record. This 
comparison shows the elapsed time covered by this trace 
record. Comparing this with the number of level 2 interruptions 
contained in the trace record indicates the i/o activity during the 
elapsed time. 


The data portion of the line trace record contains a timer value and values from the 
interface control word (icw) and communication controller hardware registers at 
each level 2 interruption. Each printed line contains up to two sets of data, one for 
each of two level 2 interruptions. For detailed descriptions of these additional 
fields in the line trace records, see the Principles of Operation manual for your 
communication controller and the NCP, SSP, and EP Diagnosis Guide. 
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Field Header 

Field Contents 

LCD 

The line control definer (LCD) defines the type of protocol being 
used over the line. The lcd for a line is generally set when the 
ncp is loaded and remains unchanged throughout normal opera¬ 
tion. 

PCF 

The primary control field (pcf) defines the state of the line inter¬ 
face at any particular time. 

TIME 

This hexadecimal value indicates, in tenths of a second, the time 
elapsed between level 2 interrupts as they occur on the line 
interface as data is received. Level-two interrupts are repres¬ 
ented by the data (pdf). The value of this timer is reset to 0 
every 25.5 seconds. 

SCF 

The secondary control field (scf) is used as a status and opera¬ 
tion modifier by the communication scanner and the control 
program. 

PDF 

The parallel data field (pdf) is used as a character buffer. For a 
transmission, the program places the characters to be sent in 
the pdf, and transmits them to the line interface. For a receive 
operation, the character is assembled, then transferred by hard¬ 
ware to the pdf. 


Line Trace Output (CS Type 3) 

Figure 48 shows an example of line trace output for a 3705 Communications Con¬ 
troller with a Type 3 communication scanner. This trace record shows the oper¬ 
ating status of a line each time an ncp buffer is filled, instead of each time a 
character is transmitted. 

This example was created with prdmp, the mvs print utility, but the output looks the 
same for vm and vse, except as noted below. 

The trace fields are explained after the figure. Most fields in this record are similar 
to the last example, but the Type 3 scanner has some additional fields. For more 
detailed descriptions of these additional fields see the Principles of Operation 
manual for your communication controller and the NCP and EP Reference 
Summary and Data Areas. 

LINE LINE01 IRC(000,000) INBOUND ACTIVE RNTIME=1D 
STATUS SCF LCD PCF EPCF STAT1 STAT2 TIME ADDR CNTL I0BLXB DISP ICW CCBLV 
44 9 9 00 00 01 80 03 71 30 AA 11 1BB2 

TEXT C0B4 

Figure 48. Example of Line Trace Output (CS Type 3) 

In addition to several fields shown in the line trace fores Type 2, the following 
fields appear in the line trace for cs Type 3: 
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Field Header 

Field Contents 

EPCF 

The extended primary control field. These bits extend the 
meaning of the pcf. 

ST AT 1 

Status byte 14 of the icw. 

STAT2 

Status byte 15 of the icw. 

TIME 

This hexadecimal value indicates, in tenths of a second, the time 
elapsed between level 2 interrupts as they occur on the line 
interface as data is received. Level-two interrupts are repres¬ 
ented by the data. The value of this timer is reset to 0 every 25.5 
seconds. 

ADDR 

The sdlc frame address field. 

CNTL 

The sdlc frame control field. 

IOBLXB 

The 1-byte command field from the iob/lxb control block. 

DISP or XDISP 

mvs vm disp or vse xdisp is byte 0 from the communication 
scanner display register. 

ICW 

Byte 13 of the interface control word. 

CCBLV or LVL2 

mvs vm ccblv or vse LVL2 is the address of the level 2 interruption 
processor routine, taken from field CCBL2 in the ncp ccb control 
block. 

TEXT 

The contents of the ncp buffer being transmitted in both 
hexadecimal and ebcdic. 


mvs Network Controller Line Trace (3710 Only) 

The network controller line trace traces sdlc, bsc, and start/stop data link control 
frames sent or received by an ibm 3710 Network Controller. 

The 3710 physical unit provides a network controller line trace on a physical unit 
type 2 node. The network controller line trace traces data link control (dlc) proto¬ 
cols, such as dlc frames exchanged between a network controller and an ncp, or 
dlc frames exchanged between a network controller and a control unit. 

The network controller line trace facility also traces the synchronous data link 
control (sdlc), binary synchronous control (bsc), and start/stop dlc frames that are 
sent or received by a line adapter. 

When tracing an sdlc or bsc line, you can choose to trace all the frames (control 
and data) or just the data frames. All frames are traced on a start/stop line. 

mvs When to Use the Network Controller Line Trace 

Run this trace if you have an incorrect output problem, a performance problem, or 
you suspect a network controller problem. 
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mvs Network Controller Line Trace Operation 

Start the network controller line trace with the modify trace command. For more 
information on the modify trace command for the network controller line trace, see 
VTAM Operation. 

Active traces stop if: 

• The network controller is reset (for example, during a failure or a configuration 
load) 

• The network controller enters slowdown (shown in the header of the rectrd ru) 

• The line fails during the trace. 

If the network controller recovers after a failure, and it is not the only one on the 
line, the trace will resume. 

Make sure that gtf is active before you start this trace. Use tap with netctlr speci¬ 
fied to format and print the output. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 

mvs Network Controller Line Trace Output 

vtam receives the trace data from a network controller in a series of rectrd rus, 
which are put into trace records. These records are passed to gtf, which stores 
them in a trace output data set, sysi.trace. Use tap to print the trace output. 

Scanner Interface Trace (3720, 3725, and 3745 Only) 

The scanner interface trace, a joint function of vtam and the ncp, records the oper¬ 
ating parameters of a line whenever a 3720, 3725, or 3745 Communication Con¬ 
troller sends or receives a message. Although the trace is controlled by vtam, the 
information in the trace records is collected by the ncp. The scanner interface 
trace records the operating status of a line whenever the communication controller 
sends or receives a message (piu). 

When you start the trace, you can choose how many bytes of data you want to 
trace. The default is the entire piu. You can only use the scanner interface trace 
on lines operating in network control mode. 

For each communication controller, a combination of eight line traces or scanner 
interface traces can be active at a time. The number of active scanner interface 
traces to be allowed is specified during ncp generation. In a multisystem network 
in which the communication controller is connected to more than one host 
processor, the number of active traces allowed is distributed among the connected 
host processors on a first-come, first-served basis. 

Note: As the number of active scanner interface traces increases, the system 
becomes less efficient. 
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When to Use the Scanner Interface Trace 

Use the scanner interface trace to determine whether the ncp or a line is causing a 
problem. The scanner interface trace records inbound data before the ncp proc¬ 
esses it, and records outbound data after the ncp processes it. Therefore, if out¬ 
bound data is correct in a scanner interface trace, but the device does not react 
properly, the problem is in either the line or the device. 

Scanner Interface Trace Operation 

Start the scanner interface trace with the modify trace command or the trace start 
option. 

The count option allows you to choose how many bytes of data you want traced (0 
to 254 or all). The default is the entire piu. 

For more information on the modify command for the scanner interface trace, see 
VTAM Operation . For more information on the trace start option, see \/TAM Instal¬ 
lation and Resource Definition. 

mvs Make sure that gtf (with trace^usr) is active before starting this trace. Use 
tap with input = line to format and print the output. 

vm Use cptrap (with a format id of 3D) to collect scanner interface trace data. Enter 
the etrace command, using the gtrace and group operands. Use trapred or tap to 
format and print the output. 

vse Use tap to format and print the output. 

For more information on printing trace output, see “Printing Trace Records’’ on 
page 223. 


Transmission Group Trace 

The transmission group trace, a joint function of vtam and the ncp, records the 
sequence of Pius being sent through a transmission group. The transmission group 
trace shows piu traffic on a transmission group as if the transmission group were a 
single line. The sequence of Pius traced is the sequence of their entry to and exit 
from the transmission group, not the sequence of actual transmission along the 
physical lines in the transmission group. The line trace shows the sequence of Plus 
transmitted and received on a physical line. 

When to Use the Transmission Group Trace 

Use the transmission group trace instead of a line trace if your failure is restricted 
to sessions using a specific transmission group and you have more than one active 
line in a tg. 

Note: vtam can start a transmission group trace only for the resources that it owns. 
A data host, which does not own any ncps, cannot start a transmission group trace. 
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Transmission Group Trace Operation 

Start the transmission group trace with the modify trace command. The name 
specified in the id operand is the line “associated” with the transmission group 
trace. 

The trace is started for the transmission group in which the specified line resides. 
This line and its associated link station must be active before the transmission 
group trace is started. 

If a line trace is already active for the chosen line within a transmission group, you 
must stop it before starting a transmission group trace. 

Once activated, the transmission group trace remains active until one of the fol¬ 
lowing occurs: 

• The operator stops the trace. 

• The associated line or link station is deactivated or fails. 

• The ncp goes through Auto Network Shutdown. 

• The ncp goes into slowdown mode. 

If the transmission group trace is ended because the associated line or link station 
fails or is deactivated, the operator can restart it by issuing the modify command 
for another line in the tg. 

For more information on the modify trace command for the transmission group 
trace, see VTAM Operation. 

mvs gtf (with trace = usr) must be active to use this trace. Use prdmp or tap to 
format and print these trace records. For prdmp, specify usr = (line) or usr = (FF 2 ) on 
the edit option. For tap specify input = line. 

vm Use cptrap (with a format id of 3D) to collect transmission group trace data. 
Enter the etrace command, using the gtrace and group operands. Use trapred or 
tap to format and print the output. 

vse Use tprint or TAP. 

For more information on printing trace output, see “Printing Trace Records” on 
page 223. 
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Transmission Group Trace Output 

mvs vm Figure 49 is an example of transmission group trace records. 


vse Figure 50 on page 255 is an example of transmission group trace records. 

The trace fields are explained after each figure. In addition to the fields described 
here, additional operating system dependent fields may appear (in mvs and vm). 
For a description of these fields, see “mvs Fields in VTAM Trace Output” on 
page 225 and “ VM VM-Only Fields in VTAM Trace Output” on page 226. 

LINE LINE23 LRC(000,000) INBOUND ACTIVE RNTIME=Q0 

TEXT 42000000 2000009A 00000004 0000000C 0E00000B 
0005808D 00QACB80 00A0 

TEXT 6E000000 F000009A 00000004 00000001 00000000 
00000032 20000000 00000823 00000000 00000000 
00000123 00000040 

Figure 49. MVS vm Example of Transmission Group Trace Output 


The following fields appear in the transmission group trace for mvs and vm: 


Field Header 

Meaning 

line linename 

The name of the line “associated” with the transmission group 
trace. This line name was specified in the modify trace 
command that started the transmission group trace. 

lrc (xxx.yyy) 

The number of records lost since the last trace record was 
written because the trace facility could not get a vtam buffer, 
xxx is the destination's lost record count, and yyy is the source's 
lost record count. 

INBOUND 

The direction of the data with respect to this host. It always says 
inbound because the data is always received from the ncp. 

ACTIVE 

The status of the line being traced. In Figure 49, the line status 
is active. The line status may also appear as deactivate or 

SLOWDOWN. 

• active means that the line trace is active. 

• deactivate means that the line trace is not active. 

• slowdown means that the line trace is not active because the 
ncp is in slowdown mode. 

A status of deactivate or slowdown appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 
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Field Header 

Meaning 

RNTIME — hh 

Is a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communication con¬ 
troller sent the completed line trace record to vtam. This value 
is taken from a timer that is reset to 0 every 25.5 seconds. This 
value can be compared with the time value for the first level 2 
interruption data contained in the second part of the line trace 
record. This comparison shows the elapsed time covered by 
this trace record. Comparing this with the number of level 2 
interruptions contained in the trace record indicates the I/O 
activity during the elapsed time. 

TEXT 

Shows the th and rh for each piu that traversed the data path 
through the transmission group. If the piu is for data flow 
control, session control, or network control, the full ru portion of 
the piu is also included in the trace record. The ru may contain 
sense data. If the piu is function management data (fmd) and 
contains an fm header, six bytes of the ru are included in the 
transmission group trace record. If an fmd piu without an fm 
header is traced, the ru is not included. 

LINE LINE23 
TEXT 42000000 
00000032 
TEXT 6E000000 
00000123 

87.150/09:15:06.18 ACTIVE RNTIME=Q0 

2000009A 00000004 0000000C OEOOOOOB 0005808D 000ACB80 00A00000 

20000000 00050101 0000000B 0040 

F000009A 00000004 00000001 00000000 0005808D 000ACB80 00A00000 

00000040 00050101 0000000B 0000 

Figure 50. vse 

Example of Transmission Group Trace Output 

The following fields appear in the transmission group trace for vse: 

Field Header 

Meaning 

line linename 

Is the name of the line associated with the transmission 
group trace. This line name was specified in the modify 
trace command that started the transmission group trace. 

yy.jjj/hh:mm:ss.hh Is the year (yy), the Julian date (jjj), and the time to hun¬ 

dredths of a second (hh:mm:ss.hh) that trace record was 
written. 


To find this field in Figure 50, look for “87.150/09:15:06.18” 
in the first trace record. 

LRC(xxx.yyy) 

Is the number of records lost since the last trace record 
was written because of the inability of the trace facility to 
get vtam buffers, xxx is the destination's lost record count, 
and yyy is the source's lost record count. This field is not 
present in the trace record unless records are lost. 
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Field Header 

Meaning 

TRANSMIT Or RECEIVE 

Indicates, for full-duplex lines, the side of the line used for 
the transmission. 

ACTIVE 

The status of the line being traced. In Figure 50, the line 
status is active. The line status may also appear as deacti¬ 
vate or SLOWDOWN. 

• active means that the line trace is active. 

• deactivate means that the line trace is not active. 

• slowdown means that the line trace is not active 
because the ncp is in slowdown mode. 

A status of deactivate or slowdown appears only in the last 
record to be sent for that line. It means that no more data 
will be sent until the trace is activated again for that line. 

RNTIME = hh 

Is a timer field, where hh is a hexadecimal value indi¬ 
cating, in tenths of a second, the time at which the commu¬ 
nication controller sent the completed line trace record to 
vtam. This value is taken from a timer that wraps around to 
0 after 25.5 seconds. This value can be compared with the 
time value for the first level 2 interruption data contained in 
the second part of the line trace record. This comparison 
will show the elapsed time covered by this trace record. 
Comparing this with the number of level 2 interruptions 
contained in the trace record indicates the i/o activity 
during the elapsed time. 

TEXT 

Shows the th and rh for each piu that traversed the data 
path through the transmission group. If the piu is data flow 
control, session control, or network control, the full ru 
portion of the piu is also included in the trace record. The 
ru may contain sense data. If the piu is function manage¬ 
ment data (fmd) and contains an fm header, six bytes of the 
ru are included in the transmission group trace record. If 
an fmd piu without an fm header is traced, the ru is not 
included. 
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vse Dynamic Trace Utility for Communication Adapters 

This trace facility of vse applies to the 4361 communication adapter, and to the 9370 
telecommunications subsystem. It can record communication adapter line traces 
on tape while the line and the communication adapter are both active. It can also 
print selected trace entries after a line-related error has occurred. 

The communication adapter line trace should be used when line-related errors are 
suspected on lines attached to the communication adapter, for example: 

• Frequent unexplained line outages 

• Unusual sense or status in i/o error messages 

• Device outages that cannot be explained with i/o or buffer traces. 

For more information on using this trace facility, see the VSE Service Aids manual. 


Operator Commands 

You can control and monitor the vtam network with both predefined specifications 
(start options) and operator commands. These commands include the display 
command and the modify command. 

• DISPLAY 

- “Display Buffer Pool Use” on page 258 

- “Display NCP Storage" on page 263 

- “Display Network Status” on page 263 

- “Display Route Status” on page 265 

- “Display Route Test” on page 266. 

• MODIFY 

- “Modify Input/Output Problem Determination" on page 270 

- "Modify Message Module Identification” on page 270 

- “Modify NCP Intensive Mode Recording” on page 271 

- “Modify SDLC Link Level 2 Test" on page 271 

- “Modify Tuning Statistics” on page 272. 

• For more information on problem determination, see the other parts of this 
chapter or the table of contents. 

For information on vtam start options, see VTAM installation and Resource Defi¬ 
nition. For information on commands, see VTAM Operation. 

Note: Several other licensed ibm programs can also be used to monitor and collect 
error statistics from the vtam network: the NetView program, nccf. npda, and nldm. 
The Network Program Products General Information manual describes these 
licensed programs. 


LY30-5601-1 €' Copyright IBM Corp. 1984, 1989 


Chapter 7. Using VTAM Service Aids 257 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


Display Buffer Pool Use 

You can use the display bfruse command to display information about buffer use. 

In response to this command, vtam indicates that the display is for buffer use and 
issues a series of messages that contain monitoring information. For each buffer 
pool, this information includes: 

• Buffer pool id 

• Flags (Q or F): Q shows a request is queued for this pool; F shows dynamic 
buffering has failed for this pool 

• Size of each buffer in this pool 

• Current total number of buffers in this pool 

• Current count of buffers available (the number not in use) 

• Largest number of buffers this pool has expanded to at any time 

• Largest number of buffers in use at any time 

• Cumulative count of the number of times each buffer pool has expanded 

• Expansion and contraction thresholds 

• The expansion increment (the number of buffers to be added to a buffer pool 
during dynamic expansion) 

• vtam's intermediate routing node buffer use limit (irnlimit), current buffer use, 
and maximum buffer use 

• mvs vm vtam's csa buffer use limit (csalimit), current buffer use, and maximum 
buffer use 

• mvs vm Maximum amount of csa in use since vtam was started. 

If the display bfruse command is used while an sms (buffer use) trace is running, 
the fields max total, max used, and times exp reflects buffer usage only since the 
last trace record was written, because the sms trace resets these fields. 

For more information about the display bfruse command, see VTAM Operation. 

mvs vm Sample Output 

Figure 51 on page 259 and Figure 52 on page 260 are examples of the output 
from a display bfruse command in mvs and vm. 

For example, in Figure 51, for the buffer pool with id iooo, each buffer has 183 
bytes, 200 buffers are currently in the pool, and 166 of those are available. The 
largest number of buffers the pool has ever contained is 200, and the maximum 
ever used at one time is 49. The buffer pool has not been expanded. 

If the number of available buffers drops to 5 (the expansion threshold in this 
example), vtam expands the pool by adding 20 buffers (the expansion increment). 

If the number of available buffers reaches the contraction threshold, vtam frees 
buffers (in pages) until the number of buffers in the pool is less than the contraction 
threshold, vtam frees buffers only if there is a full page in which none of the buffers 
is being used. 

An n/a (not applicable) in the expansion/contraction column indicates that the user 
did not set an expansion increment. 
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If dashes (.) appear in place of the contraction threshold, the buffer pool is not 

currently expanded (although it might have been expanded previously). 


IST350I VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 


IST632I 

BUFF 

BUFF 

CURR 

CURR 

MAX MAX 

TIMES 

EXP/C0NT 

EXP 

IST633I 

ID 

SIZE 

TOTAL 

AVAIL 

TOTAL USED 

EXP 

THRESHOLD 

INCR 

IST356I 

1000 

00183 

00200 

00166 

00200 00049 

00000 

00005/. 

00020 

IST356I 

LP00 

01344 

00016 

00013 

00016 00006 

00000 

00001/- 

00003 

IST356I 

WP00 

00184 

00350 

00344 

00350 00006 

00000 

00001/- 

00020 

IST356I 

LF00 

00068 00048 

00042 

00048 00006 

00001 

00001/00093 00046 

IST356I 

CRPL 

00116 

00500 

00497 

00500 00004 

00000 

00004/- 

00030 

IST356I 

SF00 

00064 

00051 

00051 

00051 00000 

00000 

00001/- 

00051 

IST356I 

SP00 

00112 

00002 

00002 

00002 00000 

00000 

00001/- 

00032 


IST449I CSALIMIT = NOLIMIT, CURRENT = 0001887K, MAXIMUM = OO01887K 
IST449I MAXIMUM CSA USED = Q001887K 

IST595I IRNLIMIT = NOLIMIT, CURRENT = OO0OOOOK, MAXIMUM = 0000000K 
IST314I END 

Figure 51. MVS VM Example of DISPLAY BFRUSE Output for VTAM Pre-V3R2 
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260 


IST350I 

IST920I 

IST9211 

IST922I 

IST923I 

IST924I 

IST92QI 

IST9211 

IST922I 

IST923I 

IST924I 

IST92GI 

IST9211 

IST922I 

IST923I 

IST924I 

IST920I 

IST9211 

IST922I 

IST923I 

IST924I 

IST92GI 

IST9211 

IST922I 

IST923I 

IST924I 

IST92GI 

IST9211 

IST922I 

IST923I 

IST924I 

IST920I 

IST9211 

IST922I 

IST923I 

IST924I 


VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 


1000 Q 

F BUFF SIZE 
TIMES EXP 
CURR TOTAL 
MAX TOTAL 

0123456789 

0123456789 

0123456789 

0123456789 

EXP INCREMENT 
EXP/CONT THRESH 
CURR AVAILABLE 
MAX USED 

01234 

012345/6789 

0123456789 

0123456789 

LP00 Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

WP00 Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

LF00 Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

CRPL Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

SF00 Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

SP00 Q 

F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 


IST314I END 

Figure 52. MVS VM Example of DISPLAY BFRUSE Output for VTAM V3R2 


display bfruse output can help you identify possible sources of problems. The fol¬ 
lowing chart shows some problem symptoms and the corresponding buffers to 
check in sms trace output: 


For this symptom: 

Check this buffer pool: 

i/o hang 

IOBUF 

Session failure 

crplbuf and lpbuf 

vtam hang 

LPBUF 
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vse Sample Output 

Figure 53 and Figure 54 on page 262 are examples of the output of a display 
bfruse command in vse. 

For example, in Figure 53, for the buffer pool with idlf, each buffer has 407 bytes, 
92 buffers are currently in the pool, and 54 of those are available. The most buffers 
the pool has ever contained is 140, and the maximum ever used at one time is 127. 
The buffer pool has been expanded 24 times. 

If the number of available buffers equals 7, vtam will expand the pool by adding 12 
buffers. If the number of available buffers becomes greater than 31, vtam will 
attempt to free enough of the extents to reduce the number of available buffers 
below 31 (provided these buffers are on the same page or pages). 

An n/a (not applicable) in the expansion/contraction column indicates that the user 
did not set an expansion increment. 

If dashes (-) appear in place of the contraction threshold, the buffer pool is not 

currently expanded (although it might have been expanded previously). 


5D50I VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 


5G32I 

BUFF 

BUFF 

CURR 

CURR 

MAX 

MAX 

TIMES 

EXP/C0NT 

EXP 

5G33I 

ID 

SIZE 

TOTAL 

AVAIL 

TOTAL 

USED 

EXP 

THRESHOLD 

INCR 

5D56I 

VF 

02048 00020P 

00008P 

N/A 

00012P 

N/A 

N/A 

N/A 

5D56I 

VP 

02048 

00512P 

00170P 

N/A 

00456P 

N/A 

N/A 

N/A 

5D56I 

SF 

00356 

00022 

00020 

00022 

00016 

00000 

00003/- 

00005 

5D56I 

LF 

00407 

00092 

00054 

00140 

00127 

00024 

00007/00031 00012 

5D56I 

SP 

00112 

00022 

00022 

00022 

00000 

00000 

00003/- 

00017 

5D56I 

LP 

01016 

00013 

00009 

00015 

00001 

00001 

00003/00007 00002 

5D56I 

WP 

00160 

00075 

00074 

00135 

00004 

00004 

00003/- 

00012 


5F95I IRNLIMIT = NOLIMIT, CURRENT = 0000000K, MAXIMUM = 0000000K 
5D14I END 


Figure 53. VSE Example of DISPLAY BFRUSE Output for VTAM Pre-V3R2 
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IST350I VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 


IST920I 

VF 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 


EXP/CONT THRESH 

*****^y^*** 

IST922I 


CURR TOTAL 

0123456789P 

CURR AVAILABLE 

0123456789P 

IST923I 

IST924I 


MAX TOTAL 


MAX USED 

0123456789P 

IST920I 

VP 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 


EXP/CONT THRESH 

*****^/ fa*** 

IST922I 


CURR TOTAL 

0123456789P 

CURR AVAILABLE 

0123456789P 

IST923I 

IST924I 


MAX TOTAL 

****^| l^-k-k-k 

MAX USED 

0123456789P 

IST920I 

SF 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 

IST922I 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 

IST923I 

IST924I 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

IST920I 

LF 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 

IST922I 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 

IST923I 

IST924I 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

IST920I 

SP 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 

IST922I 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 

IST923I 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

IST924I 

IST920I 

LP 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 

IST922I 


CURR TOTAL 0123456789 

CURR AVAILABLE 

0123456789 

IST923I 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

IST924I 

IST920I 

WP 

Q F BUFF SIZE 

0123456789 

EXP INCREMENT 

01234 

IST9211 


TIMES EXP 

0123456789 

EXP/CONT THRESH 

012345/6789 

IST922I 


CURR TOTAL 

0123456789 

CURR AVAILABLE 

0123456789 

IST923I 

IST924I 


MAX TOTAL 

0123456789 

MAX USED 

0123456789 

IST595I 

IRNLIMIT = NOLIMIT, 

CURRENT = 0000000, MAXIMUM = 

0000000 

IST314I 

END 






Figure 54. VSE Example of DISPLAY BFRUSE Output for VTAM V3R2 


display bfruse output can help you identify possible sources of problems. The fol¬ 
lowing chart shows some problem symptoms and the corresponding buffers to 
check in sms trace output: 


For this symptom: 

Check this buffer pool: 

i/o hang 

LFBUF 

Session failure 

LPBUF 

vtam hang 

LPBUF 
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Display NCP Storage 

You can dynamically request and display any selected portion of ncp storage by 
using a display ncpstor command. Up to 256 bytes can be displayed for each 
command. For the 3720 or 3745 communication controller, you can use the display 
ncpstor command to display up to 256 bytes of an ncp dump or state vector stored 
on the disk. 

vtam issues message IST24SI (or5C45i, for vtam V3Ri or V3R1.2 running under vse) to 
display the storage contents. 

Notes: 

1. The ncp storage to be displayed may change while it is being formatted for 
transmission. 

2. You cannot display ncp storage at a data host, because a data host does not 
own any ncps. 

For more information on the display ncpstor command, see VTAM Operation. 


Display Network Status 

You can use the display command to display status information about the vtam 
network. For example, a request for display of a physical unit or of a logical unit 
indicates whether that node has been added by dynamic reconfiguration, display 
also indicates whether a logical unit, a physical unit, or a link is supported by the 
Network Terminal Option (nto). 

Note: From a data host you cannot display the status of either an ncp or the ncp's 
subordinate resources, because a data host does not own any ncps. 

Two types of node status are displayed when you use the display command: The 
status field shows the current state of the node; the desired state field shows the 
desired state. Both states are taken from the rdte for the node. 

The desired state is the condition that vtam processing is attempting to establish 
for the node. Previously entered operator commands or recovery processing may 
establish the desired state for a node. When processing is completed, the desired 
state and the current state should be equal. See VTAM Messages and Codes for 
descriptions of the resource status codes used in response to the display 
command. 

The display command displays the status of the following: 

• Any or all application programs 

• Any or all host physical units 

• Any or all active major nodes 

• An ncp in a channel- or link-attached communication controller 

• A channel-attachment (ca) major node and its subordinate links and link 
stations 

• Any or all lines and the traces associated with them. This display includes the 
line control for each line. 

• Any or all line groups 
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• Any or all cross-subarea link stations 

• Any or all physical units or bsc cluster controllers 

• Any or all logical units 

• Any or all lu-lu session states 

• Routes used to access other subareas (which are defined by active path defi¬ 
nitions) 

• Any or all cross-domain resource managers (cdrms). 

• Any or all cross-domain resources (cdrscs) 

• mvs vse The adjacent sscps that can be used on a path to a given destination 

• mvs Any or all tso users, by user identification. This display indicates whether 
the tget/tput trace is active for a tso user. 

mvs vm Displays for SNA Network Interconnection 

If sna network interconnection is in use, the display command shows: 

• The network id associated with a resource (if any) 

• For a cross-network cdrsc, the real resource name. 

• For a cross-network cdrm, the real name of the gateway node through which 
the sscp-sscp session passes, and the network address as known in the 
requesting host's network. 


Trace Status 

The display command also shows a 5-character resource status code (xxxxx) for 
the transmission group trace, sit trace, generalized piu trace, or network controller 
line trace when applicable. 

• Line trace status, transmission group trace status, and sit trace status are part 
of the response to the display id = linename command. They appear in the 
messages shown in the following example. 

Note: In this example, both the istxxxi and sxxxi message ids are shown. (Mes¬ 
sages beginning with the number 5 pertain only to vtam V3R1 or V3R1.2 running 
under vse.) In the actual output only one of these message ids will appear, 
according to the operating system used. 

V3R1 & 

MVS VM V3R1.2 
V3R2 VSE VSE 

IST655I 5F55I LINE TRACE STATUS=xxxxx TG TRACE STATUS=xxxxx 

IST588I 5E88I SIT TRACE STATUS=xxxxx 

• Generalized piu trace status is part of the the response to the display 

id = nodename command. It appears in the messages shown in the following 
example. 

Note: In this example, both the istxxxi and sxxxi message ids are shown. (Mes¬ 
sages beginning with the number 5 pertain only to vtam V3R1 or V3R1.2 running 
under vse.) In the actual output only one of these message ids will appear, 
according to the operating system used. 
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V3R1 & 

MVS VM V3R1.2 
V3R2 VSE VSE 

IST752I 5H52I GPT TRACE STATUS=xxxxx 

• mvs The status of the network controller line trace is part of the response to the 
display traces command. This command tells you if a 3710 network controller 
is tracing and gives you the names of the resources being traced. The status 
appears in this message: 

IST838I TRACE STATUS DISPLAY FOR ID=network controller name 

IST839I PU NAME DOWNSTREAM LINE NAME 

IST840I nnnnnnnl nnnnnnn2 

IST840I nnnnnnnl nnnnnnn2 

IST314I END 

For more information about the display command and the status it displays, see 
VTAM Operation. 

See VTAM Messages and Codes for more information on resource status codes. 


Display Route Status 

The display route command shows the status and availability of virtual and explicit 
routes. For more information on the display route command, see VTAM Operation . 

vtam displays the status of selected routes and, if test = yes is specified, does a 
route test on the routes selected in the display command. (See “Display Route 
Test” on page 266.) 

The vtam operator may select the origin of the routes to be displayed or tested. 

The origin may be either a host processor or an ncp. 

The display of status for the routes selected is formatted as shown in Figure 55. 

Note: In this example, both the istxxxi and sxxxi message ids are shown. (Mes¬ 
sages beginning with the number 5 pertain only to vtam V3R1 or V3R1.2 running 
under vse.) In the actual output only one of these message ids will appear, 
according to the operating system used. 


V3R1 & 

MVS VM V3R1.2 
V3R2 VSE VSE 

IST535I 5F35I ROUTE DISPLAY nnn FROM SA sal TO SA sa2 


IST808I 

5I08I 

ORIGIN PU 

= origpu DEST 

PU = destpu 


IST536I 

5F36I 

VR 

TP 

STATUS 

ER 

ADJSUB 

STATUS 

IST537I 

5F37I 

X 

y 

status 

z 

aaa 

status 

IST537I 

IST314I 

5F37I 

5D14I 

X 

END 

y 

status 

z 

aaa 

status 


Figure 55. DISPLAY Route Status 


mvs vm If you are using sna network interconnection, the display route command 
can be used to show the status and availability of adjacent vtam networks. The 
resulting display is the same as shown in the previous example, except that 
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. message istsosi contains an additional field, netio= netid, to show the 10 of the adja¬ 
cent network. See the VTAM Operation manual for information on displaying 
routes in adjacent networks. 

See VTAM Messages and Codes for a complete description of the variable data 
contained in the messages that result from the display route command. 

It is possible for the test results for an explicit route to be lost before they are dis¬ 
played. For example, if a node or a link along the explicit route fails between the 
time the test request flows outbound and the time the test results flow inbound, the 
results will be lost. If this occurs, re-enter the display route command for that 
explicit route. 

Note: You can use the session monitor of the NetView or nldm licensed program to 
collect more information about routes. If all the required session monitors or 
nldms along the route are in session, you can test the entire route, from one 
session end to the other. For more information, see NetView Operation or NLDM 
Operation. 

Display Route Test 

If a route test was requested, results of the test are sent asynchronously to the 
console of the operator requesting the display. If the route test failed, the results 
are also sent to the console of the host that owns the rejecting subarea node. If the 
host owning the rejecting subarea is the same host that initiated the route test, that 
host will receive the test results twice. 

To be tested, the explicit route must be known to vtam. This means the explicit 
route must be defined to vtam, or must at some time have been operative. 

Successful Route Test 

If test=yes is set and the route test is successful, the following asynchronous mes¬ 
sages follow the route status display messages previously described. 

The test results are formatted as shown in Figure 56. 

Note: In this example, both the istxxxi and sxxxi message ids are shown. (Mes¬ 
sages beginning with the number 5 pertain only to vtam V3Ri or V3R1.2 running 
under vse.) In the actual output only one of these message ids will appear, 
according to the operating system used. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 


IST538I 

5F38I 

ROUTE TEST ### IN 

PROGRESS 



IST533I 

5F33I 

ER n SUCCEEDED IN 

ROUTE TEST ### 



IST797I 

5H97I 

FROM 

VIA ADJACENT 

DEST 

ER LENGTH 

IST644I 

5G44I 

ffffffff 

TG aaaaaaaa 

dddddddd 


IST534I 

5F34I 

sss 

t xxx 

yyy 

1 

IST798I 

5F98I 

nnnn 





Figure 56. Output of a Successful Route Test 


In this example, 

• ffffffff is the name of the origin physical unit 

• aaaaaaaa is the adjacent physical unit 
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• dddddddd is the name of the destination physical unit 

• sss is the subarea number of ffffffff 

• t is the transmission group number 

• xxx is the subarea number of aaaaaaaa 

• yyy is the subarea of dddddddd 

• 1 is the explicit route length 

• nnnn is the network id of the node being displayed. 


Failed Route Test 

If the explicit route test fails because vtam is unable to send the Explicit Route Test 
ru into the network, a message tells why the test cannot be performed. This 
message is shown in the following example. 

Note: In this example, both the istxxxi and sxxxi message ids are shown. (Mes¬ 
sages beginning with the number 5 pertain only to vtam V3R1 or V3R1.2 running 
under vse.) In the actual output only one of these message ids will appear, 
according to the operating system used. 

V3R1 & 

MVS VM V3R1.2 
V3R2 VSE VSE 

IST510I 5F10I ROUTE TEST ### FAILED - reason 

If the explicit route test is initiated by vtam but fails, the messages in Figure 57 will 
show the reason for the test failure. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 


IST533I 

5F33I 

ER 0 FAILED IN ROUTE TEST 8 



IST797I 

5H97I 

FROM VIA 

ADJACENT 

DEST 

ER LENGTH 

IST644I 

5G44I 

ffffffff TG 

aaaaaaaa 

dddddddd 


IST534I 

5F34I 

sss t 

xxx 

yyy 


IST798I 

5H98I 

nnnn 




IST572I 

5F72I 

REJECTING TG 

ADJACENT 


ER MASK 

IST816I 

51161 

rrr g 

zzz 


iraranm 

IST573I 

5F73I 

<ER NOT DEFINED,> 






<A REQUIRED TG IS NOT 

ACTIVE,> 




<ER NOT REVERSIBLE,> 

<ER EXCEEDS MAXIMUM LENGTH,> 

UNEXPECTED TYPE BYTE X'##',» 

Figure 57. Output of a Failed Route Test 
In this example, 

• ffffffff is the name of the physical unit which originated the er_test 

• aaaaaaaa is the adjacent physical unit 

• dddddddd is the name of the destination physical unit 

• sss is the subarea number of ffffffff 

• t is the transmission group number 

• xxx is the subarea number of aaaaaaaa 

• yyy is the subarea of dddddddd 

• nnnn is the network id of the node being displayed 

• rrr is the rejecting subarea 

• zzz is the adjacent subarea 
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• mmmm is the explicit route mask 

• g is the transmission group number. 

Location of Failure in a Route Test 

The variable text in message 5731 can help you determine which direction the route 
test was going when it failed. If the reason is “tg not active" or “migration,” the 
adjacent subarea follows the rejecting subarea in the route being tested. There¬ 
fore, the problem is in the adjacent subarea or the link to the adjacent subarea 
from the rejecting subarea. (See Figure 58.) 


Possible 
location 
of failure 



Figure 58. Route Test Failure (TG NOT ACTIVE or MIGRATION) 
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If the reason is “not reversible," “max er length," or “not defined," the adjacent 
subarea precedes the rejecting node in the route being tested. (See Figure 59.) 

Check to see if the problem is a path definition error. If not, it may be a vtam error. 


Possible 
location 
of failure 


4 



^ OUTBOUND 


Rejecting 


Adjacent 

subarea 

INBOUND . 

subarea 


- 



Direction of route test 


Figure 59. Route Test Failure (NOT REVERSIBLE, MAX ER LENGTH, or NOT DEFINED) 

The er mask field indicates which er numbers the rejecting subarea can use to 
send data back to the host that requested the test. (These explicit routes are called 
reverse explicit routes.) For example, an er mask field of hex 88 (binary 10001000) 
means that the “0” and “4" bits of the mask are turned on, so er numbers 0 and 4 
can be used to send data back to the host that requested the test. If message 
IST 5731 or 5F73I says an explicit route is “not reversible”, that means the rejecting 
subarea does not have the reverse explicit routes in its path definitions. 

It is possible for the test results for an explicit route to be lost before they are dis¬ 
played. For example, if a node or link along the explicit route fails between the 
time vtam sends the test request and the time vtam receives the test results, the 
results will be lost. If this occurs, re-enter the display route command for that 
explicit route. 

See VTAM Messages and Codes for complete explanations of the messages 
resulting from the display route command. 
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Modify Input/Output Problem Determination 

The input/output problem determination (iopd) facility detects pending i/o oper¬ 
ations for the sscp, pus, nos, and lus components of vtam, and reports those oper¬ 
ations to the vtam operator. These operations are represented by a waiting 
request element (wre) queued to an i/o locked queue anchor block (lqab). 

The iopo facility searches the i/o lqab queues at a user-defined time interval, speci¬ 
fied with the 101 nt option. The iopd facility then writes message pair ists 30 i/ists 32 i 
(or 5F30I/5F32I, for vtam V3R1 or V3R1.2 running under vse) for each operation that has 
been pending longer than the specified time interval. 

The message pair includes a 10-character i/o operation identifier (usually an ru 
name or operator command), the names of the origin and destination nodes, the 
name of the node for which i/o is pending, and the event id associated with the i/o 
operation. 

For more information on event ids, and for a complete description of message pair 
ISTS30I/ISTS32I (or 5F30I/5F32I), see VTAM Messages and Codes. 

These messages are only an indication that a problem may exist. The longer an 
operation remains pending (for example, the more a message is written for the 
same request unit), the more likely it is that a problem exists. See “Wait 
Procedure" on page 29 for more information on identifying pending i/o problems. 

To use the iopd facility, use the modify iopd command or the ioint start option. The 
modify iopd command is described in VTAM Operation. The ioint start option is 
described in VTAM Installation and Resource Definition. 

Note: During initialization of a large vtam network, you may see more pending i/o 
operations than usual. If you are using the iopd facility to track i/o problems 
during initialization, the number of message pairs written can degrade your 
network's performance. 

You can use the racntwre field of istracon (the vtam constants module) to 
instruct the iopd facility to write just one message pair for each type of 
pending i/o operation, rather than one pair for each operation. The resulting 
reduction in the number of messages written can improve your network's 
performance during initialization. 

See VTAM Customization for a complete description of racntwre and for 
information on using istracon. 

Modify Message Module Identification 

You can choose to include in vtam messages the last five characters of the vtam 
module that issued the message. The module name abbreviation appears between 
the message id and the beginning of the message text. To insert or delete module 
name abbreviations, use the modify msgmod command or use the msgmod start 
option. 

Specifying msgmod=no stops the insertion of module ids into messages. 

msgmod=no is the default; the issuing module name does not appear in messages 
unless msgmod=yes is specified in either the modify command or the msgmod start 
option. 
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For more information on the modify msgmod command, see VTAM Operation. For 
more information on the msgmod start option, see VTAM Installation and Resource 
Definition. 

For example, vtam message xxxxx (where xxxxx is an operating system-unique 
message number) normally appears as: 

xxxxx DUMP OF ncpname COMPLETE 

If msgmod=yes were specified in either the modify command or start option, the 
message would appear as: 

xxxxx INFXI OUMP OF ncpname COMPLETE 

Notes: 

1. Any message that exceeds the maximum message length after the insertion of 
the module id will be truncated. 

2. If your installation has changed the message text and omitted the message id, 
the module name will be the first item in the message. 


Modify NCP Intensive Mode Recording 

When you receive a large number of temporary errors for a line, but not enough to 
create a permanent error, you can use intensive mode recording to find the cause 
of the error. 

Intensive mode error recording allows each temporary error over a link (and its 
cause) to be recorded and signaled to vtam. 

Start intensive mode recording with the modify imr command. For more informa¬ 
tion on this command, see VTAM Operation. 

The modify imr command causes the owning sscp to send a request to the ncp. The 
ncp then builds and sends recms rus to the sscp each time an error occurs. The 
sscp writes these error records on the logrec or sysrec file. It may also optionally 
pass them to a user-defined communication network management (cnm) applica¬ 
tion program. 


Modify SDLC Link Level 2 Test 

Use the sdlc link level 2 test to test an sdlc link between an ncp and a physical unit 
attached on a multipoint line, between two ncps, or between vtam and any sec¬ 
ondary physical unit attached via icasdlc lines (vm and vse only). By running this 
test over an extended time, you can increase the possibility of repeating an inter¬ 
mittent error that is hard to re-create. 

Note: If you just want to test connectivity to a physical unit, activate the physical 
unit instead of using a link level 2 test. 

To test the link, vtam sends test data over the link from the controlling ncp to the 
remote station (ncp or peripheral physical unit). The data is then echoed back to 
the sending ncp. This ncp then compares the data received with the data sent and 
forwards the results to vtam. 
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Notes: 

1. For iCA-attached devices, vtam sends test data over the ica attachment to the 
physical unit. The data is then echoed back to vtam. 

2. vtam may also receive an LL2 request from an iCA-attached ncp, in which case 
vtam echoes the data back to the ncp. 

When vtam receives the test results, it sends message IST5491 (or SF49I, for vtam V3Ri 
or V3R1.2 running under vse) to the initiating console to indicate how the link level 2 
test ended: data returned without errors, data returned with errors, or no data 
returned because of an inoperative link or initialization error. See VTAM Mes¬ 
sages and Codes for a complete message description. 

When testing the link between an ncp and a peripheral physical unit, the physical 
unit name in the id operand must be inactive ("dedicated” to the test). Other phys¬ 
ical units on the same link, however, may remain active. 

When testing the link between two ncps, the primary link station is the one named 
in the LL2 command, and the secondary link station is the one responding to the 
test. You must start the test from the primary link station. The primary link station 
must be inactive; the secondary link station must be active; and the link must be 
active. 

Start this test with the modify LL2 command. See VTAM Operation for more infor¬ 
mation about the modify LL2 command. 

This command causes the sscp to send a test ru to the ncp to which the test ter¬ 
minal is connected. The ncp returns test results to the requesting sscp in a Record 
Test Results ru. 

The test results include: 

• The number of test frames transmitted by nodename 

• The number of test frames received by nodename 

• The number of test frames received without error by nodename (that is, suc¬ 
cessfully returned by the test station). 

If the above three numbers are not the same, that indicates an error in the link or a 
physical unit. Using a line trace might help you further isolate the problem. 


Modify Tuning Statistics 

To record tuning statistics for vtam, issue the modify tnstat command or use the 
tnstat start option. 

For detailed information about recording tuning statistics and using these statistics 
to improve communication between vtam and a channel-attached communication 
controller or host processor, see VTAM Customization. 
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Dumps 

The following dumps may be used for problem determination: 

• “Network Control Program (NCP) Dump” on page 274. 

• “Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only)” 
on page 277. 

• “Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 
Only)" on page 277. 

• mvs Dumps 

- “mvs Abend Dump” on page 284 

- “mvs SNAP Dump” on page 284 

- “mvs Stand-Alone Dump" on page 284 

- “mvs SVC Dump” on page 284. 

• vm Dumps 

- “vm SDUMP Dump” on page 286 

- “vm GDUMP Dump” on page 286 

- “vm DUMP Command” on page 286 

- “vm VMDUMP Command” on page 286. 

• vse Dumps 

- “vse Program-Initiated Dump” on page 287 

- “vse SDAID Dump Facility” on page 287 

- “vse Stand-Alone Dump Utility" on page 287 

- “vse DUMP Command” on page 287. 
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Network Control Program (NCP) Dump 

You can get either dynamic or static dumps of ncp storage in a communication con¬ 
troller. 

You can use the display ncpstor command (described on page 263) to dynamically 
dump up to 256 bytes of ncp storage. When you request a dynamic dump, vtam 
sends repeated dispstor rus to the ncp until the entire contents of ncp storage have 
been transmitted. The ncp continues to operate during this period. As a result, the 
dump represents ncp storage over a period of time. 

You can get a static dump with the vtam dump facility (for a channel-attached or 
link-attached communication controller). You can also get a static dump with the 
independent dump utility (for a channel-attached communication controller only). 
Figure 60 on page 275 summarizes the methods and requirements for dumping 
the ncp. 

mvsncp dumps are not allowed on lines or data links (including multipoint subarea 
links) for which ipl = no was specified in the ncp definition deck. Therefore: 

• Code ipl = yes for any line or link which might be used to ipl or dump any 
attached type 4 physical unit. 

• If ipl = yes was not specified for a line with one or more type 4 physical units 
attached, do not try to load or dump over that line. 

Note: If you do not specify a value for ipl, the default is ipl = no. 

If you have a 3720 or 3745 Communication Controller with a hard disk in your 
network, you can transfer ncp, moss, and csp dumps from the communication con¬ 
troller disk to the host. You can also transfer the ncp load module from the host to 
the disk. If you need to restart the ncp, you can load the ncp load module from the 
disk. 

Specifically, the following tasks are allowed with the 3720 or 3745 Communication 
Controller with hard disk: 

• You can save the ncp load module to the disk. 

• You can load the ncp load module from the disk. 

• You can transfer an ncp, moss, or csp dump stored on the disk to the host. 

• You can purge an ncp, moss, or csp dump stored on the disk. 

• You can control automatic loading and dumping of the ncp to or from the disk. 

• You can display up to 256 bytes of ncp dump or state vector stored on the disk. 

When to Use the NCP Dump 

A dump of the ncp should be taken whenever the ncp abnormally terminates or 
when an error is suspected in the ncp. It may be possible to determine that a 
problem exists in the ncp by using the vtam i/o trace to determine what Pius are 
being sent to and received from the communication controller and by using the ncp 
line trace to determine what is happening on the lines between the communication 
controller and the link-attached logical unit. 
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Using the VTAM Dump Facility 

To dump the ncp, use the modify dump command with type = ncp specified. For 
more information on this command, see VTAM Operation . You must execute a 
separate job to print the dump. 

Note: A data host cannot load or dump an ncp. 

You can use the dumpds operand of the modify dump command to specify the file 
into which you want the dump transferred. If you omit this operand, vtam uses the 
file specified on the pccu definition statement for the ncp. 

Note: If you use the same file on the modify dump command as was named on the 
pccu definition for the ncp, an earlier ncp dump may be overwritten. 

If you omit the dumpsta operand, vtam uses the link station specified on the vary 
act command or the pccu definition for the ncp, in that order. 

mvs vm If you are using sna network interconnection, and you want a gateway ncp 
to perform a dump, you can set its link station name on the dumpsta operand only if 
that ncp is in the same network as the host processor requesting the dump. 

If you set autodump = yes on the pccu definition statement, a dump is taken automat¬ 
ically if the ncp abnormally terminates. This dump is written to the dump file 
named on the dumpds option of the pccu definition statement. If autoipl = yes is 
specified on the pccu definition, the ncp is automatically reloaded after the dump is 
taken. With the 3720 or 3745 Communication Controller with hard disk, you can 
specify dumpload = yes on the vary act command, which automatically stores the 
dump on the disk and loads the ncp load module from the disk. (For more informa¬ 
tion about dump commands, see VTAM Operations.) 

Note: For the 3705 only, the ncp is partially overwritten in the communication con¬ 
troller storage when the dump is taken. If the ncp is running with the partition emu¬ 
lation program (pep), the emulation routines are included in the dump and are also 
partially overwritten. The 3705 must be reactivated after the dump is taken. 


Method of 

Starting NCP Dump 

Channel or 

Link Attached 

Requirements 

NCP Status 

Printing Dump 

MODIFY DUMP 
command, 

OPTION = DYNA 

Both 

DUMPDS must 
be specified 

Active throughout 
dump, no reacti¬ 
vation required. 

Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 

MODIFY DUMP 
command, 

OPTION = STATIC 

Both 

DUMPDS must 
be specified 

Deactivated when 
dump is com¬ 
pleted; operator 
; must reactivate 

the NCP. 

Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 


Figure 60 (Part 1 of 2). Dumping the NCP 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 7. Using VTAM Service Aids 275 




“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


Method of 

Starting NCP Dump 

Channel or 

Link Attached 

Requirements 

NCP Status 

Printing Dump 

VTAM Error 

Recovery Proce¬ 
dures (automatic) 

Both 

PCCU definition 
requirements: 

DUMPDS must 
be specified 

AUTODMP = YES 
must be speci¬ 
fied 

AUTOIPL may 
be specified 

Activated after 
dump is com¬ 
pleted if 

AUTOIPL = YES 
and restart is suc¬ 
cessful, or if 
AUTOIPL = NO 
and operator 
requests commu¬ 
nication controller 
IPL. 

Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 

VTAM Error 

Recovery Proce¬ 
dures (with operator 
intervention) 

Both 

PCCU definition 
requirements: 

DUMPDS must 
be specified 

AUTODMP = NO 
must be speci¬ 
fied 

AUTOIPL may 
be specified 

Activated after 
dump is com¬ 
pleted if 

AUTOIPL = YES 
and restart is suc¬ 
cessful, or if 
AUTOIPL=NO 
and operator 
requests commu¬ 
nication controller 
IPL. 

Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 

SSP independent 
dump utility: 

IFLREAD (MVS and 

VM) or IFUREAD 
(VSE) 

Channel 
attached only 

See the NCP and 
SSP Generation 
and Loading 

Guide for infor¬ 
mation about 
using inde¬ 
pendent dump 
utility. 

Deallocate com¬ 
munication con¬ 
troller from VTAM 
and allocate to the 
independent dump 
utility 

i 

Done automat¬ 
ically by IFxREAD 
using IFxDUMP. 

Controller-detected 
error (3720 or 3745 
with disk only) 

Both 

VARY ACT 
requirements: 

DUMPLOAD = YES 
must be speci¬ 
fied 

Prior dump must 
have been trans¬ 
ferred to host 

Activated after 
dump is com¬ 
pleted if 

AUTOIPL = YES 
and restart is sue- 
cessful, or if 
AUTOIPL = NO 
and operator 
requests commu¬ 
nication controller 
IPL. 

Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE). 

Transfer to host 
using MODIFY 

DUMP with 

ACTION = 
TRANSFER. 


Figure 60 (Part 2 of 2). Dumping the NCP 
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Using the Independent Dump Utility (Channel-Attached Controller Only) 

To use the independent ncp dump, the communication controller must be inactive. 
For a description of the job control language needed to invoke the independent 
dump utility, see the NCP, SSP, and EP Diagnosis Guide, ncp data areas, registers, 
and codes found in an ncp storage dump are explained in the NCP and EP Refer¬ 
ence Summary and Data Areas. For more information on the contents of ncp 
storage, see the Principles of Operation manual for your communication controller. 

Nole: To use this utility in vse, a communication controller must be assigned to a 
programmer logical unit for the partition in which it is to run. When the dump is 
complete, you must take away the assignment to make the device available to vtam 
again. 

Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only) 

The communication scanner processor (csp) automatically dumps its contents 
when it detects an error, csp stores the dump on the communication controller 
disk, or on the moss diskette, and the ncp sends an alert message to the host to 
inform it of the error. You can use the modify dump command to transfer this dump 
to a dump file in the host processor. 

If you have a 3720 or 3745 Communication Controller with hard disk in your 
network, you can also purge the csp dump from the communication controller 
before sending the dump to the host. 

To transfer the contents of the csp dump, use the modify dump command with 
type=csp specified. You can use the dumpds operand of the modify dump command 
to specify the file into which you want the dump transferred. If you omit this 
operand, the dump is put into one of two dump files: 

• The file specified by the cdumpds operand of the pccu definition statement for 
the ncp 

• The file specified by the dumpds operand of the pccu definition statement for the 
ncp (if cdumpds was not specified on the pccu definition). 

After the dump has been transferred to the host, you must then run a separate job 
to print the dump. 

For more information on the modify dump command, see VTAM Operation. 

Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 
Only) 

The maintenance and operator subsystem (moss) automatically dumps its contents 
when it detects an error, moss stores the dump on the communication controller 
disk, or on the moss diskette, and the ncp sends an alert message to the host to 
inform it of the error. You can use the modify dump command to transfer this dump 
to a dump file in the host processor. After the dump has been transferred to the 
host, you must then run a separate job to print the dump. 
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To transfer the contents of the moss dump, use the modify dump command with 
type=moss specified. You can use the dumpds operand of the modify dump 
command to specify the file into which you want the dump transferred. If you omit 
this operand, the dump is put into one of two dump files: 

• The file specified by the mdumpds operand of the pccu definition statement for 
the ncp 

• The file specified by the dumpds operand of the pccu definition statement for the 
ncp (if mdumpds was not specified on the pccu definition). 

For more information on the modify dump command, see VTAM Operation. 
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MVS 


MVS 


vm Formatting and Printing Dump Output 

The service aids described in this section are available for formatting and printing 
dump output. 

ABDUMP Service Aid 

abdump operates as part of the operating system's abnormal termination (abend) 
procedure. It automatically formats and prints abend dumps and snap dumps. 

(See “mvs Abend Dump” on page 284 and 'mvs SNAP Dump” on page 284.) 

During abdump processing, vtam formats control blocks related to the abending 
task and prints them as part of the dump created by abdump. 

abdump formats the control blocks listed below. 

Note: This list is in alphabetical order; the control blocks may be ordered differ¬ 
ently in a dump. 

Control Block Description 

acdeb vtam data extent block for the abending task 

appcb lu 6.2 control block 

copr Control operator control block associated with the abending task 

cra Component recovery area for the abending task 

fmcb Function management control block and extensions for the 

abending task 

hsicb Half session information control block for the abending task 

lucb Logical unit control block associated with the abending task 

mpst Memory process scheduling table for the abending task 

nsicb Logical network services information control block for the 

abending task 

nsscb Logical network services storage control block for the abending 

task 

pst Process scheduling table for the abending task 

rab lu 6.2 resource allocation block for the abending task 

rdte Resource definition table application program entry for the 

abending task 

sab Logical resource manager session allocation block for the 

abending task 

The following information appears for each control block: 

• A header line with the name and hexadecimal address of the beginning of the 
control block. 

• Under the header, the name of each selected field (as it appears in that control 
block's mapping dsect) and the contents of the field (listed sequentially). 

• After the formatted printout, a hexadecimal dump of the entire control block. 
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Note: If the vtam formatted dump routine cannot access a field (either in the 
control block or in the chain of pointers to the control block), a note of the condition 
is made on the dump output. 

See VTAM Data Areas for a description of the fields in each formatted vtam control 
block. 

VM PRTDUMP Service Aid 

You can format vtam control blocks from gdump output, as follows: 

1. Load the dump with ipcsdump and use the prtdump command to format it or 
print it. (Figure 29 on page 157 shows an example of using prtdump.) vtam 
asks whether you want vtam control blocks to be formatted. 

2. Answer yes to format the dump, vtam then asks about vscs formatting. 

Note: Answering yes provides only the formatted portion of the dump. 

3. Answer no to print the unformatted dump. 

4. Enter the formatting options you want for vscs. vtam then asks about vtam for¬ 
matting. 

5. Enter the formatting options you want for vtam. (The formatting options are the 
same as for vtammap; see page 282). If you request formatting, the vtam 
control blocks listed below may be formatted, depending on which virtual 
machine was dumped, and which options you selected. 

Note: This list is in alphabetical order; the control blocks may be ordered dif¬ 
ferently in a dump. 

Control Block Description 

acdeb vtam data extent block 

appcb lu 6.2 control block 

atcvt vtam communication vector table 

bpcb Buffer pool control block 

bpdty Buffer pool directory 

conft vtam configuration table 

COPR Control operator control block 

cra Component recovery area (active) 

erte Explicit route table entry 

fmcb Function management control block (chained to fmcb exten¬ 

sions) 

fmcbe fmcb extensions (queued to lucb) 

fmcbext Function management control block extension 

hscib Half session information control block 

ittrc Internal trace table 

lucb Logical unit control block (chained to acdeb) 

mpst Memory process scheduling table 

ncb Node control blocks (pointed to by rdte) 
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nsicb Logical network services information control block 

nsscb Logical network services storage control block 

pagtb Storage pool page table 

pst Process scheduling table 

pte Storage pool page table entry 

pxb Pool expansion blocks (chained to bpcb) 

qab Queue anchor block for the rdt 

rab lu 6.2 resource allocation block 

rote Resource definition table entry 

sab Logical resource manager session allocation block 

sib Session information block 

sibix Session information block initiation extension 

sibrx Session information block resource extension 

sibx Session information block cross-network extension 

spanc Storage pool anchor block 

vrblk Virtual route block 

wre with eids Waiting request element with event ids 

The following information appears for each control block: 

• A header line with the name and hexadecimal address of the beginning of 
the control block. 

• Under the header, the name of each selected field (as it appears in that 
control block's mapping dsect) and the contents of the field (listed sequen¬ 
tially). 

• After the formatted printout, a hexadecimal dump of the entire control 
block. 

Note: If the vtam formatted dump routine cannot access a field (either in the 
control block or in the chain of pointers to the control block), a note of the con¬ 
dition is made on the dump output. 

See VTAM Data Areas for a description of the fields in each formatted vtam 
control block. See “vm GDUMP Dump” on page 286 for more information on 
this dump. 


mvs PRDMP Service Aid 

prdmp formats and prints svc dumps and high-speed stand-alone dumps. (High¬ 
speed stand-alone dumps are not ordinarily formatted, but they can be formatted 
with this service aid.) Use prdmp and supply the vtammap control card in the sysin 
data. (The vtammap options are shown below.) Use the sumdump option on the 
prdmp command if you want to print the summary information contained in the 
dump. During prdmp processing, vtam formats and prints certain vtam control 
blocks and the vtam internal trace table. See the diagnostic manuals for your oper¬ 
ating system for more information on prdmp. 
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You can choose one or more of the following options on the vtammap control card. 
The default is all. 


Option Specified 

ALL 

RDTFULL(name) 

RDTHiER(na/ne) 

RDTSUM(name) 

ROUTES 

ses (name) 


STORAGE 

VTAM 


VTBASIC 


PRDMP Action 

Formats the vtbasic, rdtfull, vtam, storage, routes, and 
ses options. 

Formats all resource definition table entries (rotes) and 
node control blocks (ncbs). If name is specified, formats 
only the rdte specified by name. 

Formats the specified rdte and all rotes below it in the 
rote hierarchy. If name is omitted, formats all rotes. 

Formats the specified rdte in short form (one line for each 
rdte). If name is omitted, formats all rdtes in short form. 

Formats explicit route table entries (ertes), virtual route 
block (vrblk). 

Formats the rdte specified by name, and formats all sibs 
and rdtes in session with name. The specified name can 
be any session endpoint, such as a logical unit, terminal, 
or application program. It also formats acdebs, appcbs, 

COPRS, FMCBS, FMCBEXTS, HSICBS, LUCBS, NSICBS, NSSCBS, 

rabs, sabs, sibixs, sibrxs, and sibxs. 

If name is not specified, it formats all sibs and rdtes, as 
well as acdebs, appcbs, coprs, fmcbs, fmcbexts, hsicbs, 

LUCBS, MPSTS, NSICBS, NSSCBS, PSTS, RABS, SABS, SIBIXS, 

sibrxs, and sibxs. 

Formats bpcbs, pxbs, spancs, pagtbs, and ptes. 

Formats the following: 

• rdt and RDTES 

• Memory process scheduling table (mpst) and process 
scheduling table (pst). 

• ACDEBS, APPCBS, COPRS, FMCBS, FMCBEXTS, HSICBS, LUCBS, 
NSICBS, NSSCBS, RABS, and SABS. 

• NCBS (LDNCB. ICNC8 and XCNCB). 

• Buffer pool control blocks (bpcbs), extension blocks 
(pxbs), storage pool anchor block (spanc), storage pool 
page table (pagtb), and storage pool page table entries 

(PTES). 

• Locked queue anchor block (lqab). 

• Waiting request elements (wres) and event identifiers 
(eids). 

• Modules from the atcvt, in the form modname address 
modname address, sorted by module name. 

Formats the atcvt, the configuration table (conft), the vtam 
internal trace (vit), and the component recovery areas 

(CRAS). 
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For example, to format the vit, atcvt, conft, cra, rdt, and rdtes, specify the vtbasic 
and rdtfull options, like this: 

VTAMMAP VTBASICjRDTFULL 

prtdump formats the same control blocks as those listed in “ vm PRTDUMP Service 
Aid” on page 280. 

See “ mvs Stand-Alone Dump” on page 284 and “ mvsSVC Dump” on page 284 for 
more information on these dumps. 

mvsSADMP Service Aid 

sadmp formats and prints low-speed stand-alone dumps. During sadmp processing, 
vtam formats selected control blocks and prints them as part of the dump created 
by sadmp. 

See the diagnostic manuals for your operating system for more information on 
sadmp. See “ mvs Stand-Alone Dump” on page 284 for more information on this 
dump. 

vmSDUMP Service Aid 

You can format vtam control blocks for sdump output. The procedure is the same 
as that given in “ vm PRTDUMP Service Aid” on page 280. 

With sdump, the same vtam control blocks as those listed in “ mvs ABDUMP Service 
Aid” on page 279 may be formatted, depending on which virtual machine was 
dumped. 

See “ vm SDUMP Dump” on page 286 for more information on this dump. 


LY30-5601-1 €> Copyright IBM Corp. 1984, 1989 


Chapter 7. Using VTAM Service Aids 


283 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


mvs Dumps 

Several kinds of dumps can be produced in an mvs system, depending on the type 
of failure and operator action: 

• "mvs Abend Dump” 

• “mvs SNAP Dump” 

• “mvs Stand-Alone Dump” 

• “mvs SVC Dump.” 

“mvs vm Formatting and Printing Dump Output” on page 279 tells you how to 
format and print the output. 

mvs Abend Dump 

If the appropriate dd card exists, an abend dump is produced when: 

• The operator enters a cancel command 

• An abend macroinstruction is issued 

• A job abnormally ends. 

To get an abend dump, the input stream for vtam must contain a dd statement with 
ddname sysabend. The resulting dump is written to the data set specified on the 
sysudump or sysabend dd card. The contents of the dump depend on user specifica¬ 
tions. For more information, see the Supervisor manual for your operating system. 

mvs SNAP Dump 

To get a snap dump, issue a snap macroinstruction. The resulting dump is written 
to the data set specified on the dcb operand of the snap macroinstruction. The 
dump data set must be opened before snap is issued. A separate dd statement is 
required for each job step in which snap is issued. The ddname can be any unique 
name except sysabend. sysudump, or sysmdump. The contents of the snap dump 
vary depending on the options you specify in the snap macroinstruction. The 
sdata = all or sdata = cb options include major operating-system and selected vtam 
control blocks in the dump. For more information, see the Supervisor Services and 
Macros manual for your operating system. 

mvs Stand-Alone Dump 

The stand-alone dump is produced when the operator invokes the stand-alone 
dump program. This program can be invoked when the operating system is in a 
disabled wait state or looping. The stand-alone dump may be a high-speed dump, 
which is not formatted, or a low-speed dump, which is formatted. The dump output 
is written to the tape or printer (low-speed only) specified on the output operands. 
The output for a high-speed dump can be formatted by prdmp. For more informa¬ 
tion on the stand-alone dump, see MVS Service Aids. 


mvs SVC Dump 

svc dumps are produced under these conditions: 

• vtam produces an svc dump automatically when a program exception occurs. 
vtam may or may not be terminated as part of this process. The system log 
indicates the location of the dump output and whether the dump was suc¬ 
cessful. 

• An operator may request a dump with the operating system dump command. 
This will not cause vtam to terminate. 
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• An operator uses a slip command with action=svcd specified, and an event 
occurs that matches the trap indicated in the slip. 

• A macroinstruction issues an abend, and there is a do statement with 
ddname = sysmdump. 

• An sdump macroinstruction is issued. 

• System recovery routines produce an svc dump if vtam causes an error, such 
as a program exception or abend. 

An svc dump is written to a SYSi.DUMPnn data set (if allocated), the sysmdump output 
data set, or the data set specified on the dcb operand of the sdump macroin¬ 
struction. An svc dump may be printed with the prdmp system utility. For more 
information on svc dump, see the Supervisor manual for your operating system. 
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vm Dumps 

Several kinds of dumps can be produced in a vm system, depending on the type of 
failure and operator action: 

• “ vm SDUMP Dump" 

• “ vm GDUMP Dump" 

• “ vm DUMP Command.” 

• “ vm VMDUMP Command." 

For dumping cp storage, see the VMISP Operator's Guide . 

“ mvs vm Formatting and Printing Dump Output” on page 279 tells you how to 
format and print the output. 

VM SDUMP Dump 

An sdump dump is produced automatically when a machine program check or gcs 
internal error occurs. The resulting dump can be formatted and printed with the 
prtdump command of ipcs. The vtam control blocks shown in “ mvs ABDUMP 
Service Aid" on page 279 are formatted in an sdump. 

vm GDUMP Dump 

The gdump command can be entered by the vm system operator. The resulting 
dump can be formatted and printed with the prtdump command of ipcs. The vtam 
control blocks shown in “ vm PRTDUMP Service Aid” on page 280 are formatted in 
a GDUMP. 

Note: For a loop problem, do not use the gdump command. Instead, use the 
vmdump command. 


vm DUMP Command 

The dump command can be entered by the vm system operator. This command 
produces a formatted hardcopy dump. 

vm VMDUMP Command 

The vmdump command can be entered by the vm system operator. The resulting 
dump can be formatted and printed with the prtdump command of ipcs. The vtam 
control blocks shown in “ vm PRTDUMP Service Aid” on page 280 are formatted in 
a VMDUMP. 

cp should have control when you issue this command. That is, you should either 
press pai or enter #cp before issuing the vmdump command. 
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VSE Dumps 

Several kinds of dumps can be produced in a vse environment, depending on the 
type of failure and operator action: 

• “vse Program-Initiated Dump” 

• “vse SDAID Dump Facility” 

• “vse Stand-Alone Dump Utility” 

• “vse DUMP Command.” 

Note: Dumps produced by canceling vtam are of limited diagnostic value. Use 
other dump facilities to document a problem before canceling vtam. 

vse Program-Initiated Dump 

Customer programs can produce dumps by using system dump macroinstructions 
(pdump, jdump, dump). Other ibm licensed programs, such as cics/vs, also have their 
own dumping facilities, which may be useful in isolating some vtam problems. 

vse SDAID Dump Facility 

The dump facility of sdaid is useful when debugging requires a dump of one or 
more specific storage areas on the occurrence of a specific event. The output 
device can be a tape drive or a printer, sdaid output on tape can be printed with 
dosvsdmp. For more information on vse dumps, including dosvsdmp and sdaid, see 
VSE Service Aids . 

vse Stand-Alone Dump Utility 

A stand-alone dump, created with the dosvsdmp utility, is useful when the severity 
of a system malfunction (such as a hard wait state) prevents using other methods. 
The output of a stand-alone dump is printed by dosvsdmp. 

vse DUMP Command 

The dump command causes vse to produce a dump of the storage area specified in 
the command. The operator can direct the dump either to tape or to a syslst 
device. To retrieve the dump information, you can do either of the following: 

• Use dosvsdmp to have the dump information printed on the printer assigned to 
syslst. 

• Load the dumps recorded on the tape into your system's dump library and use 
Info/Analysis to retrieve the dump information. 

See VSE Service Aids for more information about retrieving dump information from 
tape. 
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Other Service Aids 


Alert Messages 

The ncp in a 3720, 3725, or 3745 communication controller sends alert messages to 
vtam whenever a serious or permanent error occurs in the communication con¬ 
troller. The ncp sends hardware error records to the maintenance operator sub¬ 
system (moss). If the moss determines that they are permanent errors, it sends 
them back to the ncp, which forwards them to all owning host processors. 

If a communication network management (cnm) application program, such as the 
NetView program, is active and authorized to receive alert messages, vtam for¬ 
wards the alert messages to that program. Otherwise, vtam sends a message to 
the operator's console. 

Recording NMVT Alerts in LOGREC or SYSREC (V3R2) 

A network management vector transport (nmvt) is a Systems Network Architecture 
(sna) request unit (ru) that contains solicited or unsolicited data, such as line sta¬ 
tistics and generic alerts, mvs vm logrec and vse sysrec are host data sets that 
contain records of various types of system failures, both hardware and software. 

vtam records all unsolicited nmvt alerts from 3745s, and ail nmvt alerts from lans 
and 9370s, in either mvs vm logrec or vse sysrec. If you have the NetView 
program, vtam also forwards the nmvt alerts to the NetView hardware monitor for 
recording. 

vtam identifies and records an nmvt alert as follows: 

• Each nmvt has an sna network services (ns) header of X'41038D'. 

• Each nmvt that is an alert has a management services (ms) major vector of 
X'0000'. 

• To determine the type of device that sent the nmvt alert, vtam checks the 
Product id subvector (X* 11') of the nmvt for the hardware machine type. Each 
type of device has its own unique machine type; for example, each nmvt alert 
that comes from a 3745 has a machine type of C'3745'. 

• vtam records the nmvt alert in logrec or sysrec as a miscellaneous data 
record (MDR;type = X'91') with a device type of nmvt (X 1 30 1 ). 

You can format and print nmvt alerts from logrec or sysrec using the Environ¬ 
mental Record Editing and Printing program (erep). For information on how to use 
the erep program, see the EREP book or the Service Aids book for your operating 
system. 

For more information on nmvts, see the NetView Hardware Problem Determination 
Reference , SC30-3366. 

VM VSE Alerts (V3R1.2 and Later) 

vtam V3R1.2 and later uses the alert function to notify an operator of an actual or 
impending loss of availability of a resource, vtam builds a network management 
vector transport (nmvt) for the alert. The nmvt can be traced with the piu option of 
theviT. The piu trace of the nmvt contains several extensions. Figure 61 on 
page 289 is an example piu trace entry of an alert nmvt. 
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D7C9E440 4399000Q 
20000000 00000001 
D7C9E4F2 00000001 
00001000 10007B00 
D7C9E4F2 01000C0A 
153C1000 2311040E 
D7C9E4F2 F0F1F3F1 
F10A06C1 C3C661E5 
D7C9E4F2 11F9F3F7 
F0F0F0F5 F60E5104 
D7C9E4F2 00003105 


00863DD8 40000000 
00000001 1C000001 
00860B00 0041038D 
000A0401 80000000 
01081057 061A0C0F 
02F5F6F6 F4F2F8F0 
F10804F0 F3F0F1F0 
E3C1D416 11011300 
F5000000 OOOOFOFO 
02000508 03400000 
52030404 0D910001 


*PIU .Q ...* 


* * 

*PIU2.* 

* . # . * 

*PIU2.* 


*.5664280* 

*PIU201311.-03010* 

*1.. ACF/VTAM.* 

*PI U2.9375.00* 

*00056.* 

*PIU2.* 

*....A.A. 


0F008000 C100C100 0QQ4A1 Q8 4Q Q3A1Q5 
Figure 61. vm vse PIU Trace Entry Example 


The nmvt ru that is traced contains the alert (X'OOOO 1 ) management services major 
vector. The alert major vector and its subvectors are described in SNA Formats 
and in the NetView Hardware Problem Determination Reference. 

In the example, the alert major vector has three subvectors that contain informa¬ 
tion to be used with “vm vse Alert Description Codes.” The subvectors are the 
Basic Alert subvector X'91 1 and two Detail Qualifier subvectors X'AI'. (There 
may be as many as three Detail Qualifier subvectors of the alert major vector in a 
single alert nmvt). The Basic Alert subvector has an alert description code of Cl 
and the Detail Qualifier subvectors have values of 0840 and 05,. 

vm vse Alert Description Codes 

The list that follows describes each alert by description code and provides the list 
of detail qualifier items that accompany the alert. 

Code Failure 

66 Open Failure: Token-Ring Lobe 

Description: The adapter detected a problem on its lobe during the wrap-test 
portion of the insertion process. The insertion process did not complete. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

67 Open Failure: Token-Ring Fault Domain 

Description: The adapter detected a beaconing condition on the ring during 
the insertion process. The insertion process did not complete. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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68 Open Failure: Token-Ring Duplicate Station Address 

Description: The adapter detected the presence of a station with its address 
on the ring during the insertion process. The insertion process did not com¬ 
plete. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

69 Open Failure: Token-Ring Remove Command Received 

Description: The adapter received a Remove Ring Station mac frame during 
the insertion process. The insertion process did not complete. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

6A Open Failure: Token-Ring Lobe 

Description: An error was detected during the insertion process that is not 
defined in the previous alerts. These conditions are not expected to occur, so 
they are included within one alert definition. The insertion process did not 
complete. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

6B Adapter Error: Local Token-Ring Adapter 

Description: A hardware error in the reporting station's adapter has 
occurred. The adapter is now inoperable. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

6C Wire Fault: Token-Ring Lobe 

Description: The reporting station's adapter detected a wire-fault condition 
on the ring. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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6D Auto Removal: Token-Ring Lobe 

Description: The reporting station's adapter has left the ring as part of the 
beacon automatic-recovery process. That is, the reporting station's adapter 
was a member of the beacon fault domain. The station removed itself from 
the token ring and ran a self test, which was unsuccessful. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

6E Remove Command Received: Network Operator 

Description: The reporting station's adapter received a Remove Adapter 
command from a lan manager and, as a result, left the ring. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

70 Token-Ring Inoperative: Token-Ring Fault Domain 

Description: The ring has been beaconing for more than 52 seconds. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

72 Token-Ring Temporary Error: Token-Ring Fault Domain 

Description: The ring was in a beaconing state for less than 52 seconds and 
then recovered. The sender of this alert does not know whether a station 
removed itself from the token ring to bypass the fault, or whether the fault 
was temporary. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

83 Link Error: LAN LLC Communications/Remote Node 

Description: The remote link station does not respond. The response timer 
(tl) has expired, causing the remote station to be polled. The retry count (n2) 
for the number of polls has been exceeded. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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84 Link Error: LAN LLC Communications 

Description: The remote link station sent a Disconnect Mode (dm) to the local 
link station. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

87 Software Program Error: LAN LLC Communications 

Description: The remote link station sent an sabme (Set Asynchronous Bal¬ 
anced Mode-Extended) to the local link that had been previously initialized 
through an sabme-ua (Unnumbered Acknowledgement) exchange. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

AO Software Program Error: LAN LLC Communications 

Description: The local link station sent an invalid or unsupported frame to 
the remote link station. That resulted in the remote link station returning a 
frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

A1 Software Program Error: LAN LLC Communications 

Description: The local link station sent an l-field when not permitted. That 
resulted in the remote link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

A2 Software Program Error: LAN LLC Communications 

Description: The local link station sent an invalid send sequence number. 
That resulted in the remote link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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A3 Software Program Error: LAN LLC Communications 

Description: The local link station sent an l-field that was too long. That 
resulted in the remote link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

AA Software Program Error: LAN LLC Communications 

Description: The remote link station sent an invalid or unsupported frame to 
the local link station. That resulted in the local link station returning a frame 
reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

AB Software Program Error: LAN LLC Communications 

Description: The remote link station sent an l-field when not permitted. That 
resulted in the local link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

AC Software Program Error: LAN LLC Communications 

Description: The remote link station sent an invalid receive sequence 
number. That resulted in the local link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

AD Software Program Error: LAN LLC Communications 

Description: The remote link station sent an l-field that was too long. That 
resulted in the local link station returning a frame reject. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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BE Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. One of the following situations has occurred: 

• A physical unit has dialed in, and there are no more available lines 
defined in the lan major node. 

• The activation of a line in a lan major node has caused the total number 
of active lines to exceed the maximum stations coded for the lan major 
node. 

• A dial out has been attempted that will cause vtam to exceed the 
maximum stations defined for the adapter. If more than one user is con¬ 
nected to the adapter, then the maximum number of stations must include 
the total number of stations for all connections. 

Detail data: 

1. Channel unit address 

2. Reason code: 

04 Dial in line not available 

08 Maximum number of stations exceeded (line activation) 

09 Maximum number of stations exceeded (dial out). 

BF Communications Subsystem Failure: Communications Subsystem Controller 
Interface 

Description: One of the channel programs for the ceti group failed. 

Detail data: 

1. Channel unit address 

2. Channel status 

3. Sense. 

CO Communications Subsystem Failure: Communications Subsystem Controller 
Interface 

Description: A command to the adapter has reported an unsuccessful com¬ 
pletion or an asynchronous indication has been received from the adapter. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

Cl Communications Subsystem Failure: Communications Subsystem Controller 
Interface 

Description: Local area network support code detected an error. The error is 
not the result of a user definition. 

Detail data: 

1. Channel unit address 

2. Reason code: 

01 maxdata segmenting error 
02 Sequence error 
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03 Invalid piu 

05 Adapter input is discarded 
06 ceti architecture violation 
07 Unexpected sabme or xid received. 

C2 Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. An invalid local or remote node address was specified. Either the sap 
address or the mac address is invalid or not recognized or the station is not 
on the ring. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

C3 Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. The maximum data size is too large or invalid. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

C4 Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. The service access point (sap) address on the port statement is 
already in use. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

C5 Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. An invalid number of stations was specified on the port statement or 
the number of lines defined in the lan major node is too large for the adapter. 

Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 
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C6 Warning: Single Station on the Ring 

Description: The adapter has opened and it is the only station on the ring. 
Detail data: 

1. Channel unit address 

2. Command 

3. Error code. 

C7 Configuration or Customization Error: Local System Operator 

Description: The local system operator has made an error in the vtam defi¬ 
nition. The station that is being activated as a lan resource is not defined to 
vtam as LAN-capable. 

Detail data: 

1. Channel unit address. 
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vm vse Description of Detail Qualifier Items 

The following list describes the items in the detail qualifier data fields of an nmvt. 


Channel unit address 

Command 


Error code 

Channel status 

Sense 

Reason code 


This is the channel unit address specified on the port 
statement that defines a ceti group. 

This is the command that was processed when the alert 
was reported. Commands are used by vtam lan support 
to communicate with the adapter. See “vm vse 
Command Values Reported in Trace Entries" for more 
about commands used by lan support. 

This is the completion status code that is associated 
with the command. 

This is the channel status that is reported for a failing 
ceti channel program. 

This is the sense that is reported for a failing ceti 
channel program. This value may be 0 if no sense data 
is available. 

This is the reason code for the failure reported by the 
alerts with description codes of BE and Cl. See the 
listing of those description codes for explanations of the 
values reported. 


vm vse Command Values Reported in Trace Entries 

Figure 62 on page 298 describes the command values reported in trace entries. 
These are the commands used by vtam lan support and the Token-Ring Subsystem 
when they communicate. 
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Command 

Value 

Description 

810000 

Set network parameters 

040C0D 

04CC0D 

Activate vtam's service access point 

040C0E 

04CC0E 

Deactivate vtam's service access point 

040C0A 

04CC0A 

Cause the subsystem to send test frames for remote station 
address resolution and to establish a logical connection with a 
remote station 

040C0B 

04CC0B 

Cause the subsystem to break a logical connection with a 
remote station 

040C20 

04CC20 

044C20 

048C20 

Perform sna exchange identification (xid) 

040D00 

04CD00 

044D00 

048D00 

Perform sabme - ua exchange 

040D01 

04CD01 

044D01 

Perform disc - ua/dm exchange 

040D10 

04CD10 

044D10 

Send and receive normal data 

040D50 

04CD50 

044D50 

Control the flow of data to and from a remote station 

040660 

04C660 

Send and receive test frames to perform vtam link level 2 (LL2) 
test 

044D1A 

Pass asynchronous status and statistics 

024D1A 

Pass asynchronous status and statistics 


Figure 62. Command Value Descriptions 

The commands in the table are in the form: 
xxyxxx 

where 

xx_xxx is the command identifier and 
y is the command type. 
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The command types for y and the direction of flow are: 


y 

Command Type 

Direction of Flow 

0 

Request 

From vtam lan support to the subsystem 

4 

Indication 

From the subsystem to vtam lan support 

8 

Response to an indication 

From vtam lan support to the subsystem 

C 

Confirmation of a request 

From the subsystem to vtam lan support 


Note: The set network parameters command flows as both a request and a confir¬ 
mation. It is always shown as 810000 in the vtam trace command fields. 


mvs Messages Issued for 3745 Bus Switching (V3R2) 

A 3745 can be configured with one or two ecus. For twin-ccu 3745s, ncp vsri sup¬ 
ports the two ecus as independent communication controllers. 

A twin-ccu 3745 can be operated such that, if one of the ecus fails, the maintenance 
and operator subsystem (moss) switches the IOC buses from the failing ecu to the 
active ecu. The operator can then activate all or part of the resources of the failing 
ecu to the other ecu. 

The bus-switch can also be performed at the operator's request. 

If the bus-switch occurs in the middle of a vtam channel operation, such as a Read 
or a Write, vtam issues messages istssii and 1ST8821. 

mvs Message IST881I: Message istssii tells the operator that vtam either was 
unable to contact a link station, or lost contact to a link station. 

This message is issued for one of the following reasons: 

• A bus is being switched from one ecu to the other. 

• A dump or load is being done on another channel. 

• A dump or load is being done by a local disk. 

When the link station becomes available (as indicated in other messages), vtam 
resumes contact processing. 

To terminate contact processing before the link station becomes available, issue a 
vary inact.f command to deactivate the link station. 

mvs Message IST882I: Message IST8821 tells the operator that vtam is waiting for a 
device end from the link station identified in message 1ST8811. 

You should check to see if the link station is online. If it is, then there is a possi¬ 
bility that ncp is being dumped or loaded over another channel adapter, and no 
further action is necessary. 

Note: If the link station is not operating, not physically connected, or not online, 
vtam never receives the device end. In those cases, you should issue a vary 
inactf command to deactivate the link station. 
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Hardware Error Recording 

During error recovery processing (erp), vtam writes outboard recorder (obr) 
records and miscellaneous data records (mdrs) to logrec or sysrec. obr records 
are written for hardware errors on channel-attached devices, (vse vm obr records 
are written for iCA-attached devices as well.) mdrs are written for hardware errors 
on NCP-attached devices. 

vtam collects the error data and puts it in logrec or sysrec. erep formats and 
prints the logrec or sysrec data set. 

obr records contain information about the following: 

• Statistics on the overflow of error counters for devices 

• Sense and status data on all channel-attached devices 

• Failures on teleprocessing devices 

• Temporary or intermittent failures on i/o devices 

• End-of-day requests 

• Permanent channel and device errors (unrecoverable errors and unit checks). 

Permanent error records show the date, time, logical unit name, type of record, 
contents of counters, failing ccw, channel device name, csw, sense information, 
device type, and flags. The time field shows the time at which the permanent error 
occurred. 

Counter overflow and end-of-day records show the date, time, logical unit name, 
type of record (counter overflow or end-of-day), contents of counters, channel or 
unit address, and device type. The time field shows the time at which the counter 
overflow or end-of-day error occurred. 

Counter overflow records are written when the sio counter, the temporary error 
counter, or a device statistics table counter is about to overflow, (vtam maintains 
two counters for each channel-attached device. One counter keeps track of the 
number of sio commands issued to the device; the other counter keeps track of 
temporary errors. Counters of unit check errors by error type are also maintained 
in the device statistics table.) 

End-of-day records are written whenever a vary inact command is entered for a 
link or channel. 

Miscellaneous data records contain the following information: 

• Statistics on the overflow of error counters for communication controllers 

• Record Maintenance Statistics (recms) rus 

• Permanent errors on NCP-attached devices. 

See the EREP manual for information on printing and interpreting these records. 


Logical Unit Connection Test (IBMTEST) 

You can enter the ibmtest command from a terminal to find out whether that ter¬ 
minal can communicate with its owning sscp. When you use the ibmtest command, 
an unformatted ru is sent through the network path supporting the lu-sscp session. 
This ru contains the ibmtest command followed by the number of times the sscp is 
to return (echo) the data to the logical unit and optional data (up to 247 bytes) being 
sent to the sscp. 
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You can increase the possibility of repeating an intermittent error that is hard to 
re-create by using ibmtest, since you can request up to 255 echoes. You can also 
use it to determine whether a suspended lu-lu session is caused by either a hard¬ 
ware problem or by a problem with vtam or an application program. 

Start this test with the following command: 

ibmtest [n][,dafa] 

n 

specifies the number of times the test data should be returned to the terminal. 
Specify n as a decimal number in the range 1 through 255. If no value is speci¬ 
fied, a value of 10 is used by default. 

data 

specifies the test data to be returned. Specify a character string of up to 247 
characters, or the maximum message length of the terminal, whichever is 
smaller. If no test data is supplied, vtam returns the alphanumeric sequence: 

'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789’ 

The ibmtest command is valid only for terminals that use the uss logon format. 

The ibmtest command must be defined in the uss table for that terminal. The 
sscpfm option for that terminal must specify something that is supported and starts 
with uss. 

Note: This echo check does not verify that a terminal can establish a session with 
an application program in the host, because the session request may specify a dif¬ 
ferent network path than the one supporting the terminal's lu-sscp session. If the 
requested path is unavailable, the session request is rejected, even though another 
path is available. 

If there are any errors, the vtam operator receives a message that contains the 
logical unit name associated with the terminal, the number of echoes that took 
place before the i/o error, and the error sense code. 


NCP Error Recording 

ncp error recording procedures create Record Maintenance Statistics (recms) rus 
that contain: 

• The initial error status that began the recovery process 

• The final error status that caused the permanent recms ru to be generated. 

recms rus are created for each adapter check, program check, unresolved inter¬ 
ruption, counter overflow, i/o operation, and permanent line error. The recms rus, 
which contain the miscellaneous data record (mdr), are sent to the vtam host that 
owns the failing component, vtam then records the mdr and writes the error infor¬ 
mation to the logrec or sysrec file. 


Patch Areas 

Patch areas are available for vtam, tso/vtam, and vscs. 
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VTAM Patch Area 

vtam supplies a fixed patch area as a separate module. You can insert short 
service programs in this area to do maintenance-related functions, istpatch is 
loaded into lpalib during vtam initialization and is pointed to by the atcptcha field 
in the atcvt. The initial size of the patch area is 64 bytes, but you can change the 
size by link-editing a module named istpatch of the desired size. 

Code the necessary change in the patch area, (istpatch follows the same coding 
rules as other modules in lpalib.) Then replace part of the failing code with a 
branch to the patch area, allowing you to bypass the failing code. 

TSO/VTAM Patch Area 

tso/vtam maintains a patch area in each module. The size of the patch area varies 
from module to module. If you need more information on using these patch areas, 
contact the ibm Support Center. 


VM VSCS Patch Area 

vscs supplies a fixed patch area as a separate module. You can insert short 
service programs in this area to do maintenance-related functions, dtipatch is 
addressable from all vscs code modules and is pointed to in the vscs internal trace 
table header. 


Using a Dump to Follow the Execution Sequence of VTAM Components 

vtam traces the flow of the execution of three vtam components, sscp, pus, and lus, 
by saving the work areas of modules in these components. The addresses of the 
module work areas are stored in either of these control blocks: 

• Network configuration services parameter list (ncspl) 

• Request/response unit processing element (rupe). 

In the rupe, the work area address can be found at rupedap. In the ncspl, the work 
area address can be found at ncsplwka. For the hex offsets of these fields, see 
VTAM Data Areas . 

The ncspl or rupe work area contains the work and save areas for each module 
invoked for the command that the ncspl or rupe represents. The module work and 
save areas provide status information that pertains to both the processing of that 
command and any interruptions in the processing. 

This status information includes a record of which modules were entered, which 
modules returned to their callers, and which modules returned with a return code. 
Each module save area contains the 4th, 5th, 7th, and 8th characters of the module 
name and the register 15 value that includes a pointer to the last module called by 
this module. 

The high-order byte of the register 15 save area also indicates the status of the last 
module called, as shown below, (mvs/xa | n 31-bit mode, the address fills register 
15, so that the status then overlays the high-order byte of the address in the reg¬ 
ister 15 save area.) 
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Byte 

Value Status Indicated 

FE The called module has returned to this module without a return code. 

FF The called module has not returned to this module. 

nn The called module has returned to this module with a return code of nn. 


Figure 63 on page 304 is an example of what the ncspl or rupe work area might 
contain for modules invoked for a vtam process. 

VTAM Error Recording for Communication Adapter Lines 

vtam error recording procedures create Record Maintenance Statistics (recms) rus 
to record information about the following conditions: 

• Recovered (temporary) sdlc link and station errors 

• Recovered (temporary) bsc link and station errors 

• Unrecoverable (permanent) sdlc link and station errors 

• Unrecoverable (permanent) bsc link and station errors 

• bsc 3270 sense/status data. 

recms rus are sent to a communication network management (cnm) application 
program, if one is designated to receive these rus. 

vst vtam also writes the recms records on sysrec. 

Formats of the recms rus created by vtam are mapped by the istrmd control block; 
istrmd is described in VTAM Data Areas. 

Use erep to edit and print the error data. (See the EREP manual.) 
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NCSPL/Rupe work area 



\ 


ISTACCRTX istaccsd 

(ISTACCSD still 

processing; 

has not returned) 


\ 


I ISTACCSD X ISTACCQE 
\ ISTACCSD X ISTACCQE 
I (No return code) 


/ 

\ 


ISTACCQE X ISTINCF1 
ISTACCSDX ISTINCF1 
(Return code = 4) 


Figure 63. Save Area Conventions 
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Chapter 8. Using the VTAM Internal Trace 

Most vtam traces show information flow between vtam and other network compo¬ 
nents. However, the vtam internal trace (vit) provides a record of the sequence of 
events within vtam. These internal events include the scheduling of processes (for 
example, post, wait, and dispatch), the management of storage (for example, 
vtalloc), and the flow of internal Pius between vtam components. 

Note: vtam disables the vit when it issues sdump to prevent the vit table from being 
overwritten. 

Together with the operator console listing and a dump, output from the vit can help 
you reconstruct sequences of vtam events and find internal vtam problems more 
easily. 


Activating the Internal Trace 

Use one of the following methods to start the vit: 

• You can use the trace start option, with type = vtam specified, to start the vit 
when you first start vtam. See VTAM Installation and Resource Definition for 
more information on how to use the trace start option. 

• You can use the modify trace command, with type = vtam specified, to start the 
vit after you have started vtam. See VTAM Operation for more information on 
how to use the modify trace command. 


Selecting Internal Trace Options 

Both the trace start option and the modify trace command have an option operand 
you can use to select vit options. You select one or more of these options to indi¬ 
cate the vtam functions to be traced: 

• The api option, for application program interfaces. 

This option helps you determine whether an application program is causing a 
problem, api entries are written for rpl macros, rpl exit routines, user exit rou¬ 
tines, and user posts. 

• The appc option, for lu 6.2 application program interfaces. 

This option helps you determine whether an lu 6.2 application is causing a 
problem, lu 6.2 entries are written for appccmd macro invocations, user posts 
and exit scheduling by lu 6.2 code, and message unit transmissions between lu 
6.2 components. 

• The cio option, for channel input and output. 

This option helps you isolate problems related to channel 1 / 0 . cio entries are 
written for attentions, error recovery, interruptions, halt i/o svc, and start i/o 
svc. 

• The esc option, for execution sequence control. 

This option helps you track in detail the flow of requests for a given process. 
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• The lock option, for locking and unlocking. 

This option helps you determine when vtam modules get and release locks. 

• The msg option, for messages. 

This option helps you correlate other vit entries with the console messages 
even if the console sheet is lost, msg entries are written for all messages to the 
vtam operator. 

• The nrm option, for network resource management. 

This option helps you follow the services of the Network Resource Manage¬ 
ment component. These include the assignment of, references to, and the 
deletion of certain vtam resources such as node names, network addresses, 
and control blocks, nrm entries are written for srt macros issued by vtam 
modules. 

• The piu option, for path information unit flows. 

This option, like the i/o and buffer contents traces, helps you isolate problems 
to hardware, to the ncp, or to vtam. piu entries are written for all i/o to and from 
vtam, which can be an advantage over i/o and buffer contents traces. 

• The pss option, for process scheduling services. 

This option helps you track the flow of requests through vtam. pss entries are 
written for the vtam macros that invoke and control pss, scheduling and dis¬ 
patching vtam routines. 

• The sms option, for storage management services. 

This option helps you isolate problems caused by storage shortages. When 
used with the sscp or pss trace options, it can also help you isolate internal 
vtam problems, sms entries are written when sms macros are used to request 
or free fixed- or variable-length buffers. 

• The sscp option, for system services control point request scheduling and 
response posting. 

This option helps you isolate a vtam problem to a specific vtam component or 
module, sscp entries are written for the request/response units (rus) sent 
between vtam components. 

The vit always traces the following exception conditions, regardless of the options 
you specify: 


Option 

Exception conditions traced 

API option 

RE, UE, or UP entries with a non-zero RPL return code or 
feedback 

APPC option 

ACA and ACI entries when issuing the following commands: 

• SEND ERROR 

• DEALLOC ABND 

• REJECT 

Other entries with non-zero return codes (except RPLGRCSC) 
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Option 

Exception conditions traced 

PIU option 

Entries for a response with a non-zero sense code 


All NRSP and DSCD entries 

SMS option 

Entries with non-zero return codes 

SSCP option 

Entries with non-zero return or sense codes 


All CPRC entries 

(No option) 

All SNAP entries. 


Note: Even if you do not specify any options, the vit still traces the above exception 
conditions, if it is active. 

Figure 64 is a summarization of the vit options and the records they create. 

Note: The abnd and lost trace records are not created by specific vit options. 

They are created as a result of exception conditions. 


API 

APPC 

CIO 

ESC 

LOCK 

MSG 

NRM 

PIU 

PSS 

SMS 

SSCP 

Alx 

ACAx 

ADPx 

ESC 

LKEX 

MSGx 

RCEx 

DSCx 

ADSP 

AREL 

CCx 

lOx 

ACIx 

ATTx 


LKSH 

OPEx 

SRTx 

PlUx 

AXIT 

FBLK 

Clx 

RE 

ACPx 

CONN 


ULKA 



NRSx 

DISx 

GBLK 

COx 

UEx 

ACRx 

DISC 


UNLK 




EXIT 

QREQ 

CPPx 

UP 

ACUx 

ERPx 






IRBx 

RELS 

CPRx 


MUx 

HlOx 






POST 

REQS 

CPWx 



INTx 






QUEx 

VTAL 




LICx 






RESM 

VTFR 




PICx 






SCHx 





PKTx 


; 




SRBx 





SlOx 





1 _ 

WAIT 




Figure 64. VIT Options and the Records They Create 


Selecting Internal or External Trace Recording 

The vit can record the trace data either internally in a trace table or externally in a 
trace file. You specify which using the mode operand of the trace start option or 
the modify trace command. 

Recording Trace in Internal Table (MODE = INT) 

If you set mode = int on the modify trace command, or if you let mode default to int, 
the vit writes the trace records in an internal trace table. The table is allocated 
and initialized in a storage area. 

• MVS The storage area is in common service area (csa). 

• VM The storage area is in common storage. 

• vse The storage area is in the vtam vfbuf buffer pool, located in the vtam parti¬ 
tion. 
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Examine the internal trace table by taking a dump of vtam with the appropriate 
storage area. 

Note: The internal trace records contain exactly the same information as an 
external file (mode = ext). 

Find the internal trace table in the dump by first locating the atcvt. Field atcittbl 
contains a pointer to the trace table. The internal trace table contains a 32-byte 
header followed by 32-byte trace records. 

The size operand of the modify trace command specifies the number of pages (1 to 
999) in storage to be allocated for the table. Because it is a wraparound table, 
specify enough pages to ensure that the vit will not overwrite important trace 
records when the table fills and begins to wrap around. 

The size operand should also reflect the amount of storage available for the 
internal trace table. If there is not enough storage available for the number of 
pages specified, you will receive a message indicating that internal trace activation 
failed. 


You can change the size of the internal trace table while the vu is running by 
issuing a modify trace or modify notrace command with a new size operand. 

Note: Issuing another modify command while the vit is running frees the current 
internal trace table and begins a new one. The trace information that the vit has 
already written in the current table is lost. 


Figure 65 shows an example of internal trace records written with mode = int and 
printed in dump output. 


V01AAEB20 

C4C9E2D7 

OA990048 

01AC8EEO 

00B69720 

80000000 

80000000 

E3E2D5C9 

O1AE1560 

*DISP.. 


.TSNI.. 


V01AAEB40 

C4C9E2F2 

01AF7120 

30000000 

00000000 

00000000 

00000000 

00000000 

01AF7120 

*DIS2.. 



★ 

VO1AAEB60 

03D2C5E7 

0A000100 

00B69738 

00000000 

819E58FA 

00000060 

00000000 

01AE156O 

*LKEX.. 




VO1AAEB80 

E4D5D3D2 

0AO00100 

0GB69738 

00G0GO00 

819E59C8 

00000000 

01800000 

01AE156O 

*UNLK.. 

.H... 


* 

V01AAEBA0 

C5E2C340 

0A000048 

81B2F228 

00869720 

81A16222 

01AF7120 

C905C9D7 

01AE156O 

*E$C .. 

.. .2. 

.INIP.. 

_* 

VO1AAEBC0 

E2D9E3C6 

0A000000 

00000000 

00010001 

81B2F33E 

01C25FD0 

40404040 

40404040 

*SRTF.. 

.3..B- 


* 

VG1AAEBE0 

C7C203D2 

0A00000O 

01C27E68 

O1ACBC90 

819F0304 

00000088 

81B302G6 

00000000 

*GBLK.. 

. .B-. 


* 

V01AAEC00 

E5E3C1D3 

0A00G000 

01B13G08 

000000FA 

819F0528 

00000005 

81B3030O 

00000000 

*VTAL.. 



* 

V01AAEC20 

C3C3D60O 

OA540000 

01'AE 179C 

C9D5C9D7 

81B2F716 

00000001 

00010000 

O0O1003E 

*CC0... 

.INIP..7_ 


* 

VG1AAEC40 

C3C3F254 

0E00000O 

G00G0000 

00000000 

00000000 

00000000 

O0GG00GO 

00000000 

*CC2... 



* 

VO1AAEC60 

O8E4C540 

OA540080 

01AC8EE0 

00B69758 

01C27E68 

00000000 

D3E4D9E3 

00000000 

*QUE .. 

.B-.... 

.LURT.. 

* 

V01AAEC80 

D8E4C5F2 

819F118C 

30480000 

00000000 

00000000 

00000000 

OG000GG0 

00000000 

*QUE2.. 



* 

V01AAECA0 

03D2C5E7 

0A0001OO 

00B69770 

00000000 

819EA24C 

00000000 

00000000 

01AE1560 

*LKEX.. 

.<_ 


_★ 

VO1AAECC0 

E4D5D3D2 

0A0G01G0 

G0B69770 

00000100 

819EA3A4 

00000000 

01800000 

01AE156Q 

*UNLK.. 



_* 


Figure 65. Internal Trace Records in Dump Output (MODE = INT) 


The first line of the internal trace table is the header, which contains the following 
status information: 


Byte (hex) 

00-07 
08-OF 
10-17 
18— IB 
1C — IF 


Contents 

Current entry time stamp (the time the current record was entered) 

Present wraparound time stamp 

Last wraparound time stamp 

Address of the most recent entry in the table 

Address of the last entry in the table. 
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Recording Trace in External File (MODE = EXT) 

If you set mode = ext on the modify trace command, the vit writes the trace records 
in an external trace file, rather than an internal trace table. You should use this 
option when you must collect large amounts of trace data, to lessen the chance of 
wraparound and lost data. 

Note: The trace data can still fill the external trace file, wrap around, and begin 
overwriting itself if you do not ensure that the external trace file is large enough. 

The external trace file contains the same information as the internal trace table. 
However, unlike the internal trace table, the external trace file does not contain a 
first-line header record. 

The external trace file is produced by gtf, and the default file name is 
sysi.trace. You can print the internal trace data with gtf. prdmp or tap. Use the 
edit option of prdmp and set the usr = (FE1) keyword. For more information on gtf 
and prdmp, see “Activating VTAM Traces” on page 222 and “ Using PRDMP" 
on page 224. For more information on tap, see the NCP, SSP, and EP Diagnosis 
Guide . Figure 66 is an example of internal trace output printed with prdmp. 


USRFD 

FE1 ASCB 

00FA2080 


J0BN 

HSTC016 






All 

ASID 

11 TYPE 

15 

EXTDS 

40 

0PT1 20 RPL 

00164DD4 

ARG 

00000000 RH3 

00 





SRTYP 

00 

VTFL 200010 CNTRL 

800000 

0PTC 

10309450 80002010 

AI2 


RTRN 

00000000 

L0GMD 


PLUNM SLUNM 





USRFD 

FE1 ASCB 

00FA2080 


J0BN 

HSTC016 






CCO 

ASID 

11 TYPE 

00 

CBID 

54 

SAVE 01DC7CF8 SVID 


ISSR 

81AE4474 








0RIG OOOOOOOAOOOC 


DEST 

OOOOOOOAOOOC 


CC2 


CBID 

54 

RU 

00000000 

63000024 01DB3450 01DAB018 00000000 

00000000 SENSE 

00000000 

USRFD 

FE1 ASCB 

00F97080 


J0BN 

HSVTAM 






SRTF 

ASID 

RC 

00 

PARM 

OOOOOOOOGOOAOeOC ISSR 

81E4403E 

SRTE 

01F35E80 NETID 


USRFD 

FE1 ASCB 00F97080 


J0BN 

HSVTAM 






CCI 

ASID 

66 TYPE 

00 

CBID 

54 

SAVE 01F5C950 SVID 

INS1 

ISSR 

81E3A20C 








0RIG OOOOOOOAOOOC 


DEST 

OOOOOOOAOOOC 


CC2 


CBID 

54 

RU 

0C81QA01 

63000024 01DB3450 01DAB018 00000000 

0A000C00 SENSE 

00000000 

USRFD 

FE1 ASCB 

00FA2080 


J0BN 

HSTC016 






UP 

ASID 

11 TYPE 

15 

EXTDS 

40 

CODES 000000 RPL 

00164DD4 

ECB 

00000000 AREA 

00000000 







RLEN 

00000000 

CID 

00000000 FBK2 

00000000 

USRFD 

FE1 ASCB 

0QF97080 


J0BN 

HSVTAM 






CCI 

ASID 

66 TYPE 

00 

CBID 

58 

FLAGS 80 RC 

00 

SAVE 

01DC7C58 SVID 








ISSR 81E10890 CPCB 

00000000 

58488000 00000000 


SVC 

020 ASCB 

00FA2Q80 

CPU 0000 

J0BN 

HSTC016 

OLD PSW 075C0014 00961F5E TCB 005FF1F8 M0DN SVC- 

-T2 


R15 00000000 R0 00000000 R1 005A027G 
PUS' 805A03G8 


USRFD FE1 ASCB 00F97080 J0BN HSVTAM 

CCI ASID 66 TYPE 00 CBID 58 FLAGS 80 RC 00 SAVE 010C7C58 SVID 

ISSR 81E10890 CPCB 00000000 58488000 00000000 

Figure 66. Internal Trace Records in GTF Output (MODE= EXT) 

The trace file is produced by cptrap. You can format the file with trapred. For 
a full explanation of printing trace records, see “ Using CPTRAP and TRAPRED” 
on page 225. Figure 67 on page 312 is a sample of the output. 
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3D OE VTAM VM/SI USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3CB2BAA40 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE1 

VTFR ISSR 0AD1D4 AREA 00105308 SP« 000000E5 LENGTH 00000368 RC 00000000 INIT 00000000 00000000 

3D OE VTAM VM/SI USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3CEA29E00 
LENGTH CF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID - FO 
EVENT IDENTIFICATION = EFE1 

CCI FLGS 00 ISSR 09D2EA CBID 54 SAV 106938 SVID I NS 1 CID 10011001 RU 00000000 00000000 00000000 

3D OE VTAM VM/SI USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3D1131C80 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE1 

CUE ISSR A1289E PST 5485C008 PAB 108436D8 WG 00 ELM 104F40 PABCHN 00000000 NAME NORT 
RPH 20000000 

3D OE VTAM VM/SI USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3D3807860 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE1 

FBLK ISSR A10EEA AREA 00104E20 ANCH 00849928 LENGTH 00000060 RC 00000000 INIT 500AA664 
00000000 

3D OE VTAM VM/SI USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3D5E01C80 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE1 

Figure 67. VM Internal Trace Records in CPTRAP Output (MODE = EXT) 


vse The external trace file is produced by tprint, and the default file name is 
vtam.trace.file. Use tprint or tap to print the internal trace data. See “ VSE Using 
TPRINT” on page 227 for more information on using tprint. For more information 
on tap, see the NCP, SSP, and EP Diagnosis Guide. Figure 68 is an example of 
internal trace output printed with tprint. 


VTAM ! 

INTERNAL TRACE 

85.295/18:35:54.01 

LRC(62) 







VTAL 

E5E3C1D3 

34000000 

0088C058 

FFFFE5D7 

60718532 

00000078 

00000000 

00000000 

VTAL.... 

H_VP-.E... 


QUE 

D8E4C540 

340E0010 

3297F010 

00980BE0 

009CD010 

00000000 

D9C1E3E6 

00000001 

QUE .... 

PO..Q. 

..RATW.... 

Q'JE2 

D8E4C5F2 

6087DC70 

04400000 

00000000 

00000Q00 

00000000 

00000000 

00000000 

QUE2-G.. 



VTAL 

E5E3C1D3 

34000000 

0088C660 

FFFFE5D7 

607185B0 

00000140 

00000000 

00000000 

VTAL.... 

HF-..VP-.E... 


QUE 

D8E4C540 

34490010 

2497F9A8 

0072BF18 

0088C660 

00000000 

C3C6C6C5 

00000000 

QUE .... 

P9Y.HF-.. 

..CFFE.... 

QUE2 

D8E4C5F2 

6071886E 

04400000 

00000000 

00000000 

00000000 

00000000 

00000000 

QUE2-.H> 



VTFR 

E5E3C6D9 

34000000 

0088C058 

FFFFE5D7 

60718ABO 

00000078 

00000000 

00000000 

VTFR.... 

H_VP-. 


ADSP 

C1C4E2D7 

32000000 

0097F010 

00000000 

00000000 

00000000 

80000000 

00980BE0 

ADSP.... 

PO. 

.0.. 

DISP 

C4C9E2D7 

320E0010 

0097F01Q 

Q0980BE0 

809CD010 

80000000 

D9C1E3E6 

0OA31360 

DISP.... 

PO..Q. 

..RATW.T.- 

DIS2 

C4C9E2F2 

009CD010 

04000000 

00000000 

00000000 

00000000 

00000000 

00000000 

DIS2.... 



EXIT 

C5E7C9E3 

32000010 

3297F010 

00980BEQ 

50A439AC 

80000000 

OOA43COO 

00A31360 

EXIT.... 

P0..Q..&U.... 

...U...T.- 

AXIT 

C1E7C9E3 

32000000 

3297F010 

00000000 

00000000 

00000000 

00000000 

00000000 

AXIT.... 

PO. 



Figure 68. VSE Internal Trace Records in TPRINT Output (MODE = EXT) 
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Module Names in Internal Trace Records 

Many vtam internal trace records include the associated module names in ebcdic, 
without the ist prefix and the sixth letter. For example, you would see tssr for 
module isttscsr. You can save time by scanning for these module names when 
you are following the logic flow through vtam. You can sometimes isolate a vtam 
problem to a specific component or module without even looking at a dump. 

The first two letters in the module name, as it appears in a trace record, are the 
component id for the module, vtam component ids are listed below: 

ID VTAM Component 

AC Activation (configuration services) 

ai Application program interface (api) 

ap Process scheduling services (pss) 

at pss termination 

au Authorization or accounting exit routine 

CD Cross-domain resource manager (cdrm) 

cf Display, network operator command facilities 

co lu 6.2 control operator 

cp sscp functions 

de Deactivation (configuration services) 

es Execution sequence control (esc) 

hs lu 6.2 half-session 

in Initialization/Termination 

lu Logical unit services (lus) 

ma Maintenance services 

mg Management services 

na Network address management 

no Network operator command facilities (nocf) 

nr Network resource manager (nrm) 

ns lu 6.2 logical network services 

oc open/close 

or Storage management services (sms) 

pd Problem determination 

ps lu 6.2 presentation services 

pu Physical unit services (pus) 

ra Trace, reliability, availability, serviceability (ras) 

rm lu 6.2 logical resource management 

sd System definition 

so Inquire 

ss Session Services 

ts Transmission subsystem component (tsc) 

zb Error recovery 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Chapter 8. Using the VTAM Internal Trace 


313 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


SNAP Trace Record 

Besides recording the previously mentioned functions, you can use the vit to 
record 32, 64, 96, or 128 bytes of user-generated information in a snap trace. This 
snap trace can place additional information into avTAM module that might be useful 
in resolving avTAM problem. The vit records the specified bytes and enters the 
data as a snap trace entry in the internal trace table or in the external trace file. 

Unlike other trace entries, you do not specify the snap trace as an option of the 
modify command. Instead, you must follow these steps: 

1. Insert a record to check that atclcptr is not 0. 

2. Insert a record to check that atcractr is not 0. 

3 . Insert a call to the internal trace recording routine (istractr) in a vtam module. 
(Field atcractr in the atcvt points to the trace recording routine. See VTAM 
Data Areas for the hex offset.) 

Note: snap records cannot be taken during the early stages of vtam initialization, 
nor can they be taken during the late stages. 

The snap trace requires the following information in registers 1,14, and 15 on entry 
to the trace routine: 

Register 1 

Points to the 32, 64, 96, or 128 bytes to be recorded. 

Register 14 

Points to a 2-byte input flag field containing: 

• X 1 141C' for a 32-byte snap entry 

• X 1 142C' for a 64-byte snap entry 

• X 1 143C' for a 96-byte snap entry 

• X 1 144C' for a 128-byte snap entry. 

These flags tell the trace recording routine to record a snap trace. 

Two Bytes Past the Address in Register 14 

Is the return address to the vtam module that called the trace recording 
routine. 

Register 15 

Points to the snap trace recording routine (istractr). 

When the trace recording routine returns control to the calling module, the contents 
of register 6 are unpredictable. The contents of the other registers, however, are 
not changed. 

The snap trace record is unformatted. You should format the first 4 bytes of the 
snap record for a 1-to 4-character ebcdic record identifier (for example, C’abcd’). 

Note: The 1-to 4-character ebcdic record identifier should not match any existing 
vit record identifier. 
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Deactivating the Internal Trace 

You can stop one or more of the active vu options by issuing the modify notrace 
command with type-vtam specified. You can specify which traces are to be 
stopped using the option operand. 

If you specify option-all, all active vit options are stopped, but the internal trace 
table is not freed. Exceptions are still recorded during this idle period. 

If you specify option-end, all active vit options are stopped, and the internal trace 
table is freed. 

For complete descriptions of the modify trace and modify notrace commands, and 
start options for the vit. see VTAM Operation. 


Internal Trace Record Summary 

The following chart lists all vit entries alphabetically by record id. For detailed 
descriptions of the trace records, see “Internal Trace Record Descriptions” on 
page 338. 

Note: A zero (0) in a trace record field means that field is not used by VTAM. 


Q 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


vm Abend SNAP 


ABND 

CODE 

PST 

RPH 

SDWA 

SDWA 

ABEND PSW or 0 



ADDRESS 

ADDRESS 

ADDRESS 

FLAGS 






or 0 

or 0 



LU 6.2 Authorized 10 or 
LU 6.2TPIO (Part 1) 


ACA1 

I 

E 

0 

0 

RPL 

C 

r~ 

Q 

0 

RPL 

APPCCMD 

CONV ID 

SENSE 

or 

D 

X 

P 

P 

ADDRESS 

N 

U 


AREA 

FLAGS 

or 

DATA 

AC 11 


T 

T 

T 


T 

A 




USR FLD 

or 0 



D 

1 

6 


R 

L 




or CID 




S 




L 





or 0 



LU 6.2 Authorized 10 or 
LU 6.2 TPIO (Part 2) 


ACA2 

RETURN 

MODE NAME or 0 

LOCAL LU NAME 

REMOTE LU NAME 

or 

ADDRESS 


or 0 

or 0 

ACI2 






LU 6.2 User Post or LU 
6.2 RPL Exit (Part 1) 


ACPI 

I 

R 

R 

F 

RPL 

C 

Q 

0 

R 

R 

APPCCMD 

CONV ID 

SENSE 

or 

D 

T 

T 

D 

ADDRESS 

N 

U 


C 

C 

FLAGS 

or 0 

DATA 

ACRl 


U 

N 

B 


T 

A 


P 

S 



or 0 



N 

C 

2 


R 

L 


R 

E 


1 





D 



L 

l 



I 

c 


_ 

L 
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0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 11 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

516 

7 

8 

9 

A 

B 

C 

D 

E 

F 


LU 6.2 User Post or LU 
6.2 RPL Exit (Part 2) 


ACP2 

ECB 

RPL6 

C 

0 

R 

RPL 

RPL 

0 

or 

ADDRESS 

ADDRESS 

N 


C 

AREA 

RECORD 


ACR2 

or 


T 


V 


LENGTH 



EXIT 


R 


I 





ADDRESS 


L 


N 









D 





LU 6.2 User Exit (Part 1) 


ACU1 

I 

C 

0 

EXIT 

0 

PLU NAME 

SLU NAME or 0 


D 

0 


TYPE 


or 




D 


DEPEND 


APPLICATION ID 



_ 

E 


INFO 





LU 6.2 User Exit (Part 2) 


ACU2 

EXIT 

MODE NAME or 0 

0 


ADDRESS 




vm vsE Ada p ter (p ar t 
for V3R1.2 and later) 


ADPA 

I 

CUA 

TSCB 

NCB 

C 

*1 

I 

S 

F 

E 

0 

DATA FIELD 

ADPI 

D 


ADDRESS 

ADDRESS 

B 

C 

N 

L 

R 

N 



ADPO 





I 

K 

D 

P 

N 

D 








D 


X 

T 

T 





vm vsE Ada pt er (Part 2, 
for V3R1.2 and later) 


ADP2 


DATA FIELD 


VM VSE As y nc h ronous 

Dispatch 


ADSP 

I 

0 

PST 

0 

SYNC 

SYNC 

ASYNC 
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TPSCHED (Part 2, for 
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RETURN 
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CALLER 
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NUMBER 
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RETURN 
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Internal Trace Record Descriptions 

This section describes the vtam internal trace table records. 

On each entry, the description called “Applies to” tells which operating 
systems the entry is valid for. For mvs and vm, V3R1.1, V3R1.2, and V3R2 are 
implied unless it is stated specifically that the entry is for one or two 
releases. For vse entries, V3Ri, V3R1.2, and V3R2 are implied unless it 
clearly specifies that the entry is for one or two releases. 


vm Abend SNAP 

Entry: vmABND 

vit Option: None (Generated by snap routine) 

Event: Abend 

vit Processing Module: istractr (snap trace recording routine) 

Control is Returned to: istapces 

Applies to: vm 

This trace record is written when an abend occurs on a process that has been dis¬ 
patched by pss. This entry is not associated with any vit options, but is recorded 
as an exception condition when an abend occurs. 


G G 0 0 
Q 1 2 3 

G Q Q G 
4 5 6 7 

G G G Q 
8 9 A B 

G G Q 0 
C D E F 

1111 
G 1 2 3 

1111 
4 5 6 7 

11111111 

89ABCDEF 

ABND 

CODE 

PST 

RPH 

SDWA 

SDWA 

ABEND PSW or G 



ADDRESS 

ADDRESS 

ADDRESS 

FLAGS 






or 0 

or G 



Byte (hex) Contents 

00-03 Record id: C'abnd’ 

04- 07 Abend completion code 

08-0B pst address 

0C-0F rph address 

10-13 sdwa address or zero 

14- 17 sdwa flags or zero 

18 - 1F Abend psw or zero 
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ACA1 or ACI1 


LU 6.2 Authorized 10 or LU 6.2 TPIO (Part 1) 

Entry: ACA1 or ACM 

vit Option: appc 

Event: lu 6.2 authorized io or lu 6.2TPIO (Part 1) 

vit Processing Module: istracac 

Control is Returned to: istaicar 

Applies to: mvs (V3R2),vm (V3R2),vse (V3R2) 

The acai trace record shows lu 6.2 requests under the authorized path or lu 6.2 
requests not under the authorized path but issued by programs running under an 
authorized key. The acii trace record shows lu 6.2 requests running under a 
normal path. 



Byte (hex) Contents 

00-03 Record id: 

• C'acaT for authorized path 

• C‘aciT for normal path 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 Exit definition (rplextds) 

06 Option code byte 1 (rplopti) 

07 Option code byte 6 (rplopt6) 

08-0B rpl address 

0C appccmd control parameter value: 

X'10 1 ALLOC 
X'20 1 RESETRCV 

X 1 30' dealloc 

X 1 40 1 OPRCNTL 
X ' 50 1 PREPRCV 
X '60 1 RCVFMH5 
X 1 70 1 RECEIVE 
X 1 80' REJECT 
X 1 90 ' SEND 

0D appccmd qualify parameter value: 

X '01 1 ABNDPROG 
X 1 02 ' ABND3ERV 
X 1 03 1 ABNDTIME 
X'04' ABNDUSER 
X ' 05 1 ANY 
X '06 1 CNOS 
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X'07' CONFIRM 
X'08' CONFRMD 
X'09' DATA 
X'OA' DATACON 
X'OB' DATAFLU 
X'OC' DEFINE 
X'OD' DISPLAY 
X'OE' ERROR 
X'OF' FLUSH 
X'10‘ RQSEND 
X'11 ' SPEC 
X'12‘ ACTSESS 
X 1 13' DACTSESS 
X' 14' ALLOCD 
X' 15 ’ IMMED 

OE-OF Zero 

10-13 Address of send data or receive buffer 

14-17 APPCCMD flags (RPL6FLGS) 

18 - IB User field for lu 6.2 commands where control equals alloc or 

rcvfmh5. cid for lu 6.2 commands where control equals oprcntl and 
qualify equals either actsess or dactsess. Zero for lu 6.2 commands 
for which one of the following is true: 

• control equals oprcntl, and qualify equals cnos, define, or 

DISPLAY 

• control equals receive and qualify equals any. 

Conversation id for all other LU6.2 commands. 

1C -1F Sense data (rplssnso) or zero 
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ACA2 or ACI2 


LU 6.2 Authorized 10 or LU 6.2 TPIO (Part 2) 

Entry: ACA2 or ACI2 

vit Option: appc 

Event: lu 6.2 authorized io or lu 6.2 tpio (Part 2) 

vit Processing Module: istracac 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 

The aca2 trace record is a continuation of acai. The ACI2 trace record is a continua¬ 
tion of ACI1. 



Byte (hex) Contents 

00-03 Record id: 

• C‘aca2’ for continuation of authorized path for acai 

• C'ac^’ for continuation of normal path for acm 

04-07 Return address of the issuer of the appccmd macro 

08 - OF Mode name for lu 6.2 commands where control equals alloc. Mode 
name for lu 6.2 commands where control equals oprcntl and qualify 
equals cnos, define, or display. Zero otherwise. 

10-17 Local logical unit name for lu 6.2 commands where control equals 
alloc. Local logical unit name for lu 6.2 commands where control 
equals oprcntl, and qualify equals cnos, define, or display. Zero oth¬ 
erwise. 

18- IF Remote logical unit name for LU6.2 commands where control equals 
alloc. Remote logical unit name for lu 6.2 commands where control 
equals oprcntl, and qualify equals cnos, define or display. Zero oth¬ 
erwise. 
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ACPI or ACR1 
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LU 6.2 User Post or LU 6.2 RPL Exit (Part 1) 

Entry: ACPI or ACR1 

vu Option: appc 

Event: lu 6.2 user post (acpi) or lu 6.2 rpl exit (acri) (Part 1) 

vu Processing Module: istracac 

Control is Returned to: istaicpt and istapcsx for acpi; istapcsx and istapcue for 

ACRI 

Applies to: mvs (V3R2),vm (V3R2),vse (V3R2) 

The acpi trace record is written when an ecb is posted, signaling that the appccmd 
macro has completed execution. This trace record shows the data returned to the 
user application program. 


The acri trace record is written when an rpl exit is dispatched, signaling that the 
appccmd macro has completed execution. This trace record shows the data 
returned to the user application program. 



Byte (hex) Contents 

00-03 Record id: 

• C'acpT for ecb posting 

• C'acrT for rpl exit dispatching 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF ') 

• For vm, machine and task id 

• For vse, task id 

05 appccmd returned indicators (RPL6RTUN) 

Bit 0 FMH5 received indicator 

Bit 1 logon received indicator 
Bit 2 signal received indicator 
06 vtam return code (rplrtncd) 

07 vtam feedback code (rplfdb2 ) 

08-0B rpl address 

0C appccmd control parameter value: 

X'10 1 ALLOC 
X 1 20' RESETRCV 
X 1 30' DEALLOC 
X * 40' OPRCNTL 
X ' 50 1 PREPRCV 
X'60‘ RCVFMH5 
X ' 70 1 RECEIVE 
X 1 80 1 REJECT 
X ' 90 1 SEND 
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OD appccmd control parameter value: 

X'01’ ABNDPROG 
X'02' ABNDSERV 
X'03' ABNDTIME 
X'04’ ABNDUSER 
X'05' ANY 
X'06' CNOS 
X'07' CONFIRM 
X'08' CONFRMD 
X'09' DATA 
X'OA' DATACON 
X'OB' DATAFLU 
X'OC 1 DEFINE 
X'OD' DISPLAY 
X'OE' ERROR 
X'OF 1 FLUSH 
X' 10’ RQSEND 
X’11 1 SPEC 
X’ 12 ' ACTSESS 
X * 13 * DACTSESS 
X 1 14' ALLOCD 
X'15' IMMED 
0E-0F Zero 

10-11 lu e.2 primary return code (RPL6RCPR) 

12-13 lu 6.2 secondary return code (rpl6rcsc) 
14- 17 APPCCMD flags (RPL6FLGS) 

18 - IB Conversation id or zero 

1 C - 1 F Sense data returned (RPL6SNS1) or zero 


ACPI or ACR1 
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LU 6.2 User Post or LU 6.2 RPL Exit (Part 2) 

Entry: ACP2 or ACR2 

vit Option: appc 

Event: lu 6.2 user post (acp2) or lu 6.2 rpl exit (ACR2) (Part 2) 

vit Processing Module: istracac 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 


The ACP2 trace record is a continuation of the acpi trace record. The ACR2 trace 
record is a continuation of the acri trace record. 


G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 
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1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 
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A 

B 

C 

D 

E 
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0 

1 
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4 

5 

6 

7 

8 
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A 
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C 

D 

E 

F 

ACP2 


ECB 



RPL6 


C 

0 

R 

RPL 


RPL 






0 




or 



ADDRESS 

ADDRESS 

N 


C 

AREA 


RECORD 









ACR2 


or 







T 


V 





LENGTH 













EXIT 






R 


I 





















ADDRESS 





L 


N 































D 


















Byte (hex) 

00-03 


04-07 

08-0B 
0C 


0D 

0E-0F 


10-13 
14-17 
18 — IF 


Contents 

Record id: 

• C‘acp 2’ for continuation of acpi 

• C‘acr 2' for continuation of acri 
ecb address for ACP2 

rpl exit address for ACR2 
RPL6 address 

appccmd control parameter value: 

X' 10' for ALLOC 
X 1 20 ' for RESETRCV 
X 1 30' for DEALLOC 
X '40 ' for OPRCNTL 
X'50 1 for PREPRCV 
X'60 1 for RCVFMH5 
X ‘ 70 ’ for RECEIVE 
X 1 80' for REJECT 

X 1 90' for send 
Zero 

Indicators for the type of information received, or zero 
Bit 0 DATA 

Bit 1 data_complete 

Bit 2 datajncomplete 

Bit 3 send 

Bit 4 CONFIRM 

Bit 5 deallocate 

Address of send data or receive buffer 

rpl record length 

Zero 
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ACU1 


LU 6.2 User Exit (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


ACU1 

APPC 

lu 6.2 user exit (Part 1) 

ISTRACAC 

ISTAPCUE 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is written when an lu 6.2 user exit (either attn or tpend) is dis¬ 
patched. If both the api and appc trace options are active, and a tpend user exit is 
dispatched, vtam generates user exit trace records for both api and appc. 
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A 
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D 

E 

F 

ACU1 


I 

C 

0 

EXIT 



0 



PLU NAME 



SLU NAME 

or 0 





D 

0 



TYPE 









or 

















D 



DEPEND 





APPLICATION 

ID 














E 



INFO 























Byte (hex) 

00-03 

04 


05 

06-07 
08-0B 

0C-0F 

10-17 

18— IF 


Contents 

Record id: C'acui’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 
Exit code for user exit: 

• X'OC' for ATTN 

• X'OD' for tpend 
Zero 

For attn exit, the exit sub-type (cnos, fmhs, or loss) 

For tpend exit, the reason code 

Zero 

plu name for attn exit 
Application program id for tpend exit 
slu name for attn exit 
Zero for tpend exit 
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LU 6.2 User Exit (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


ACU2 

APPC 

lu 6.2 user exit (Part 2) 

ISTRACAC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the acui trace record. 
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E 

F 

ACU2 


EXIT 


MODE NAME 

or 0 








0 












ADDRESS 


























Byte (hex) 

Contents 

00-03 

Record id: C‘acu2’ 

04-07 

Exit address 

08-OF 

Mode name for attn exit; zero for tpend exit. 

10 — IF 

Zero 
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ADP (V3R1.2 and later) 


VM VSE Adapter (Part 1, for V3R1.2 and Later) 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM vse ADP 
CIO 

Start i/o 

ISTRAC6T 

ISTTSC6B 

vm(V3R1.2 and later), vse(V3R2) 


This trace record is created when a data transfer with the Token-Ring Subsystem is 
initiated or has completed. 


An adpa record is written when the subsystem acknowledges that an outbound data 
transfer is complete. This entry always corresponds to a previous adpo entry. Use 
the tscb field to correlate these entries. 


An adpi record is written when an inbound transfer has been received from the sub¬ 
system. An adpi trace entry may be followed by one or more adp2 entries. 


An adpo record is written when an outbound data transfer is complete. This entry 
always corresponds to a previous lico entry. Use the tscb field to correlate these 
entries. An adpo trace entry may be followed by one or more adp2 entries. 
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DATA FIELD 


ADPI 
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ADDRESS 
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T 
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Byte (hex) 

00-03 


04 

05-07 
08-0B 
0C-0F 
10 
11 
12 

13 

14 

15 

16-17 
18— IF 


Contents 

Record id: 

C'adpa’ for an acknowledge record 
C'ADPr for an inbound record 
C'adpo’ for an outbound record 
Machine and task id 

Channel device name in ebcdic (either a cua or device number) 
tscb address 
ncb address 
Control block id 

Index value acknowledged by subsystem 
Last index value presented to subsystem 
Last index value acknowledged by subsystem 
Index for the front pointer of the buffer ring 
Index for the end pointer of the buffer ring 
Zero 

Data field. 
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vm vse Adapter (Part 2, for V3R1.2 and Later) 

Entry: vmvseADP2 

vit Option: cio 

Event: Start i/o 

vit Processing Module: ISTRAC6T 

Applies to: vm (V3R1.2 and later), vse (V3R2) 

This trace record is a continuation of the adpi or adpo entries. 

00000000000000001111111111111111 

0123456789ABCDEF0123456789ABCDEF 

ADP2 DATA FIELD 

Byte (hex) Contents 

00-03 Record id: C‘adp2' 

04-IF Data field. 
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VM VSE ADSP 


vm vse Asynchronous Dispatch 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE ADSP 
PSS 

Asynchronous dispatch 

ISTRACPS 

ISTAPCAD 

VM, VSE 


This trace record is written whenever pss receives control because work has been 
scheduled (tready cond = vtam). 



Byte (hex) Contents 

00-03 Record id: C'adsp’ 

04 id 

• For vm, machine and task id 

• For vse, task id 

05-07 Zero 

08-0B pst address 

0C-0F Zero 

10-13 Synchronous TPPOSTed queue (pststpp) 

14- 17 Synchronous normal queue (pstsnrm) 

18 -1B Asynchronous TPPOSTed queue (pstatpp) 

1C - IF Asynchronous normal queue (pstanrm) 
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MVS VM Authorized 10 (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 


Applies to: 


MVS VM All 
API 

Authorized 10 (Part 1) 

ISTRACAP 

istaicir for: istoccsm for: 

SEND INQUIRE 

RECEIVE INTRPRET 

RESETSR RCVCMD 

SESSIONC SENDCMD 

SETLOGON 
SESSIONC (BIND) 
SIMLOGON 
OPNDST 
REQSESS 
OPNSEC 
TERMSESS 
CLSDST 


MVS, VM 


The following trace record shows api requests under the authorized path or api 
requests not under the authorized path but issued by programs running under an 
authorized key. The api routine istaicir or istoccsm writes the entry and then 
queues the rpl to the correct pab. See VTAM Data Areas for an explanation of the 
rpl fields. 



Byte (hex) Contents 

00-02 Record id: C'aiT 

03 rpl request type (rplreq) 

X' 15' SETLOGON 
X' 16' SIMLOGON 
X'17' OPNDST 
X'lA 1 INQUIRE 
X 1 1 B ' INTRPRET 
X'1F 1 CLSDST 
X'22’ SEND 
X'23' RECEIVE 
X'24' RESETSR 
X 1 25' SESSIONC 
X 1 27 ' SENDCMD 
X 1 28 ' RCVCMD 
X 1 29 1 REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 
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04 ID 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 


05 

Exit definition (rplextds) 

06 

Zero 

07 

Option code byte 1 (rplopti) 

08-OB 

rpl address 

0C-0F 

nib address or cid 

10 

Third byte of rh (rplrh3) 

11 

Send/receive type (rplsrtyp) 

12 

VTAM flags (RPLVTFL1) 

13 

Post/respond flags (rplvtfl 2 ) 

14 

ru chain position (rplchn) 

15-17 

ru control codes (rplcntrl) 

18- IB 

VTAM options (RPLOPTC2) 

1C— IF 

VTAM options (RPLOPTC3) 


MVS VM All 
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mvs vm Authorized 10 (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


MVS VM AI2 
API 

Authorized 10 (Part 2) 

ISTRACAP 
MVS, VM 


This trace record is a continuation of the am entry. It shows additional information 
about the plu and slu in a session established or terminated by a simlogon, opndst, 
clsdst, reqsess. opnsec, or termsess macroinstruction. This information includes 
some of the parameters exchanged and the names of the plu and slu. 



AI2 


0 

0 

0 

0 
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0 
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0 

1 

1 

1 

1 

1 

1 

5 

6 

7 

8 
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B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 


0 


RETURN 

ADDRESS 


LOGON MODE NAME 
or 0 


PLU NAME 
(if avai lab! 


1 

6 


e) 


1 

1 

1 

1 

1 

1 

i 

7 

8 

9 

A 

B 

C 

D 


SLU NAME 
(if availabl 


e) 


Byte (hex) 

00-02 

03 

04-07 
08-OF 


10-17 
18— IF 


Contents 

Record id: C‘ai2' 

Zero 

Address of the issuer of the macro 

For simlogon, opndst, clsdst, or reqsess: Logon mode name 

(niblmode) or zero if the nib is not available 

For opnsec or termsess: Zero 

plu name or zero 

slu name or zero 
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MVS VM AI3 


mvs vm Authorized 10 (Part 3) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


mvs vm 

API 

Authorized 10 (Part 3) 
ISTRACAP 

MVS, vm 


This trace record is a continuation of the AI2 entry. It shows additional information 
in a session established or terminated by a simlogon. opndst. clsdst, reqsess, or 
opnsec macroinstruction. 


AI3 


ADDRESS 
OF USER 
DATA, 
BIND, 
or 0 


Byte (hex) 

Contents 

00-02 

Record id: C'ai3’ 

03 

Zero 

04-07 

For simlogon. clsdst, or reqsess: Address of user data (rplarea) 

For opndst or opnsec: Address of bind (nibndar) or zero if the nib is not 
available 

08 — 1F 

Zero 
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MVS VM Abend RELSTORE 

Entry: mvs vm AREL 

vit Option: sms 

Event: Abend relstore 

vit Processing Module: istracsm 

Control is Returned to: istorapr 

Applies to: mvs vm 


This trace record identifies the buffers that are released by vtam when a vtam 
application program is terminated. 



Byte (hex) 

Contents 

CO 

o 

1 

o 

o 

Record id: C'arel’ 

04 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X'FF 

• For vm, machine and task id 

05 

Control block id index value 

06-07 

Zero 

08-OB 

pst address 

0C-0F 

Address of buffer being released 

10-13 

Address of the caller of the abend relstore routine 

U_ 

1 

Zero 
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mvs ATT 


mvs Attention 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


mvs ATT 

CIO 

Attention 

ISTRACCI 

ISTTSCCA or ISTTSCLA 

MVS 


• atti is written when an attention interrupt occurs for a channel-attached com¬ 
munication controller or sna cluster controller. 

• attl is written when an attention interrupt occurs for a channel attached 
non-SNA device. 

• attx is written when an attention interrupt occurs for a channel-to-channel 
attachment. 
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ATT 

T 
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0 
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NCB 



FLAG 


0 

C 
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Y 
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E 

















E 










Byte (hex) 

00-02 

03 

04 

05 

06-08 
09-0B 
0C-0F 
10-13 

14 

15 

16-17 
18— IF 


Contents 

Record id: C'att’ 

ncb type: i for icncb, l for ldncb, x for xcncb 

Address space id (or zero if address space id is greater than X'FF') 
Link station state (ncblnkst) for icncb and ldncb; station state 
(XCNSSFSM) for XCNCB 
Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Zero 

i/o completion code in field ioscod in the iosb 
Sense data in field iossns of the iosb 
Channel status word from the iosb 
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vm vse Asynchronous Exit 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE AXIT 

PSS 

Asynchronous exit 

ISTRACPS 

ISTAPCSX 

VM, VSE 


This trace record is written whenever pss exits to the operating system because 
there is no more work to do under a given task. 


AXIT 


0 

0 

0 

0 

7 

8 

9 

A 


PST 

ADDRESS 


0 0 
D E 


G 


1 

1 

1 

1 

1—* 

1 

1 

2 

CO 

4 

5 

6 


SYNC 

TPPOSTD 

QUEUE 


SYNC 

NORMAL 

QUEUE 


1 

1 

1 

1 

1 

1 

9 

A 

B 

C 

D 

LU 


ASYNC 

TPPOSTD 

QUEUE 


ASYNC 

NORMAL 

QUEUE 


Byte (hex) Contents 

00-03 Record id: C'axit' 

04 id 


05-07 
08-0B 
0C-0F 
10-13 
14-17 
18 — IB 
1 C — IF 


• For vm, machine and task id 

• For vse, task id 
Zero 

pst address 
Zero 

Synchronous TPPOSTed queue (pststpp) 
Synchronous normal queue (pstsnrm) 
Asynchronous TPPOSTed queue (pstatpp) 
Asynchronous normal queue (pstanrm) 
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CCI or CCO for RUPE 


SSCP (RUPE-Parti) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 

Applies to: 


CCI or CCO 

SSCP 

Requests/Responses with a rupe 
ISTRACSC 

istincci for inbound processing, istincco for outbound 
processing 

MVS. VM, VSE 


This trace record provides information about outbound processing, which proc¬ 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the vit is active. 


0 

0 

0 

0 

0 

0 

0 

0 

1 

2 I 

3 

4 

5 

6 

CCI 

F 

I 

C 

0 

or 


L 

D 

B 


CCO 

A 


I 





G 


D 





S 





0 

0 

0 

0 

7 

8 

9 

A 


SAVE 

AREA 

ADDRESS 


0 0 
D E 


SAVE 

AREA 

ID 


G 

1 

1 

1 

F 

0 

1 

2 


RETURN 

ADDRESS 


1 

1 

1 

5 

6 

7 


RUPE 

ORIGIN 

NETWORK 

ADDRESS 


1 

1 

1 

1 

1 

1 

9 

A 

B 

c 

D 

LU 


RUPE 

DESTINATION 

NETWORK 

ADDRESS 


Byte (hex) 

00-02 

03 


04 


05 

06-07 
08-0B 
0C-0F 
10-13 
14-19 
1A-1F 


Contents 

Record id: 

• C‘ccr for inbound processing 

• C'cco’ for outbound processing 
Flags 

• 80 = response ru 

• 40 = sense traced 

• 00 = request ru 
id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 
Control block id = X 1 54’ 

Zero 

Save area address 

Save area id (bytes 4, 5, 7, and 8 of the module name if available) 
Address of the issuer of the macro (cpcall, cpexit, or cpwait) 

For sender, network address at origin 
For sender, network address at destination 
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CC2 for RUPE 
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SSCP (RUPE - Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CC2 

SSCP 

Requests/Responses with a rupe (Part 2) 

ISTRACSC 

MVS, VM, VSE 


This trace record is a continuation of the cci or cco (rupe) entry. 


0 

0 

G 

Q 

Q 

G 

G 

G 

Q 

G 

Q 

G 

Q 

G 

G 

G 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

i 

1 

1 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CC2 

C 





FIRST 24 

BYTES 

OF RU 










SENSE 




B 

























DATA 





I 
























1 

or 

Q 





D 






























Byte (hex) 

00 — 02 
03 

04 — IB 
1C — 1F 


Contents 

Record id: C‘cc2’ 
Control block id = X , 54‘ 
First 24 bytes of ru 
Sense data or zero 
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CCI or CCO for NCSPL 


SSCP(NCSPL 


Parti) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 

Applies to: 


CCI or CCO 

SSCP 

Requests/Responses for a ncspl 

ISTRACSC 

istincci for inbound processing, istincco for outbound 
processing 

MVS, VM, VSE 


This trace record provides information about outbound processing, which proc¬ 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the vit is active. 


7 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CCI 

F 

I 

C 

F 

R 

SAVE 


SAVE 


RETURN 

CPCB 


T 

0 

DESTINATION 

or 


L 

D 

B 

L 

C 

AREA 


AREA 


ADDRESS 

OPCODE 

Y 


NETWORK 



CCO 

A 


I 

A 


ADDRESS 

ID 











P 


ADDRESS 






G 


D 

G 


















E 











S 



S 



























Byte (hex) 

00-02 

03 


04 


05 

06 

07 

08-0B 
0C-0F 
10-13 
14-17 

18 

19 

1A — 1F 


Contents 

Record id: 

• C'ccf for inbound processing 

• C'cco’ for outbound processing 
Flags 

• 80 = response ru 

• 40 = sense traced 

• 00 = request ru 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Control block id = X 1 60' 

Flags (cpcbfl) 

Return code (cpcbrc) 

Save area address 

Save area id (bytes 4, 5, 7, and 8 of the module name if available) 

Address of the issuer of the macro (cpcall, cpexit, or cpwait) 

cpcb operation code (see Appendix D, “CPCB Operation Codes” on 

page 645) 

wtd type 

Zero 

Network address at destination 
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SSCP (NCSPL - Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CC2 

SSCP 

Requests/Responses for a ncspl (Part 2) 

ISTRACSC 
MVS VM VSE 


This trace record is a continuation of the cci or cco (ncspl) entry. 


0 

0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

:c 2 

C 

RDTE 


CPCB 











0 











B 

STATE 

WTD 























I 






























0 





























Byte (hex) 

00-02 

03 

04-07 
08-0B 
0C-1F 


Contents 

Record id: C'cc 2 ’ 

Control block id = X ' 60' 

rdte state (in control block rpre) 

cpcb wtd (first four bytes) 

Zero 


360 


VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 




‘‘Restricted Materials of IBM” 

Licensed Materials - Property of IBM 


CCI or CCO, neither RUPE nor NCSPL 


SSCP (not RUPE or NCSPL) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 

Applies to: 


CCI or CCO 

SSCP 

Requests/Responses for neither rupe nor ncspl 
istracsc 

istincci for inbound processing, istincco for outbound 
processing 

MVS, VM, VSE 


This trace record provides information about outbound processing, which proc¬ 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the vit is active. 


0 

0 

0 

0 

0 

0 

0 

0i 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CCI 

F 

I 

C 

C 

R 

SAVE 


SAVE 


RETURN 

CPCB 


CPCB 


CPCB 


or 


L 

0 

B 

P 

C 

AREA 


AREA 


ADDRESS 

OPCODE 

WORD 3 

WORD 4 

CCO 

A 


I 

C 


ADDRESS 

ID 






















G 


D 

B 





























S 



F 



























Byte (hex) 

00-02 

03 

04 


05 

06 

07 

08-0B 
0C-0F 
10-13 
14-17 

18- IB 
1C- IF 


Contents 

Record id: 

• C'cci' for inbound processing 

• C'cco’ for outbound processing 
Flags 

• Bit 0: 0 = request, 1 = response 

• Bit 1: 0 = no sense, 1 = sense 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Control block id (Control block ids are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 
cpcb flag (CPCBFL) 

Return code (cpcbrc) 

Save area address 

Save area id (bytes 4, 5, 7 and 8 of the module name if available) 
Address of the issuer of the macro (cpcall. cpexit, or cpwait) 
cpcb operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

cpcb word 3 (field wtdptr) 
cpcb word 4 (field cpcbph) 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 8. Using the VTAM Internal Trace 361 




CI1 or COI 


"Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


SSCP (RUPE) 


CI1 or COI Trace Entries 

The following trace record provides information about the inbound and outbound 
requests sent to begin or end a same-network or cross-network lu-lu session. 

The cn and coi traces have two formats: 

• Format 0 is used for same-network sessions or when vtam does not know 
whether the request is for a cross-network session. This format contains parts 
1, 2, and 3 of the cin or con record, shown below. 

• Format 1 is used for cross-network sessions. This format contains parts 1, 2, 3, 
and 4 of the cm or con record, shown below. 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


CM and COI 

SSCP 

Requests (Part 1) 
ISTRACSC 

(Many modules possible) 

MVS, VM, VSE 


Part 1 of the cin or con record is for both format 0 and format 1 and contains essen¬ 
tially the same information as the cci or cco entry. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the vit is active. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CI1 

F 

I 

C 

I 

SAVE 


SAVE 


RETURN 


RUPE 



RUPE 




or 


L 

D 

B 

T 

AREA 


AREA 


ADDRESS 


ORIGIN 


DESTINATION 

COI 

A 


I 

F 

ADDRESS 

ID 








NETWORK 


NETWORK 






G 


D 

S 














ADDRESS 


ADDRESS 






S 



M 


























Byte (hex) Contents 

00-02 Record id: 

• C'CiT for inbound processing 

• C'coi’ for outbound processing 

03 Flags 

• Bit 0: 0 = request, 1 = response 

• Bit 1: 0 = no sense, 1 = sense 

• Bits 6 and 7: 00 = format 0, 01 = format 1 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 Control block id = X 1 54 ’ 
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CI1 or COI 


06-07 Initiation and termination finite state machines (taken from the session 
information block, sib) 

08 - OB Save area address 

0C - OF Save area id (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (cpcall, cpexit, or cpwait) 

14-19 Network address at origin (rupeoaf) 

1A - IF Network address at destination (rupedaf) 
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CM or COI 

SSCP (NCSPL) 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CI1 

F 

I 

C 

F 

R 

SAVE 


SAVE 


RETURN 

CPCB 


T 

0 

RUPE 




or 


L 

D 

B 

L 

C 

AREA 


AREA 


ADDRESS 

OPCODE 

Y 


DESTINATION 

COI 

A 


I 

A 


ADDRESS 

ID 











P 


NETWORK 






G 


D 

G 


















E 


ADDRESS 






S 



S 



























Byte (hex) 

Contents 

00-02 

Record id: 

• C'cn’ for inbound processing 

• C’coi’ for outbound processing 

03 

Flags 

• Bit 0: 0 = request, 1 = response 

• Bit 1: 0 = no sense, 1 = sense 

• Bits 6 and 7: 00 = format 0, 01 = format 1 

04 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 

Control block id^X'SO' 

06 

Flags (cpcbfl) 

07 

cpcb return code (cpcbrc) 

08-0B 

Save area address 

OC-OF 

Save area id (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 

Address of the issuer of the macro (cpcall, cpexit, or cpwait) 

14-17 

cpcb operation code (see Appendix D, "CPCB Operation Codes" 
page 645) 

18 

wtd type 

19 

Zero 

1A-1F 

Network address at destination (ncspldaf) 
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CI1 or C01 


SSCP (not RUPE or NCSPL) 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CI1 

F 

I 

C 

C 

R 

SAVE 


SAVE 


RETURN 

CPCB 


CPCB 


CPCB 


or 


L 

D 

B 

P 

C 

AREA 


AREA 


ADDRESS 

OPCODE 

WORD 3 

WORD 4 

C01 

A 


I 

C 


ADDRESS 

ID 






















G 


0 

B 





























S 



F 



























Byte (hex) 
00-02 

03 


04 


05 

06 

07 

08-0B 
0C-0F 
10-13 
14-17 

18- IB 
1C —IF 


Contents 

Record id: 

• C'cn’ for inbound processing 

• C'coi’ for outbound processing 
Flags 

• Bit 0: 0 = request, 1 = response 

• Bit 1: 0 = no sense, 1 = sense 

• Bits 6 and 7: 00 = format 0, 01 = format 1 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Control block id (Control block ids are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 

CPCB flag (CPCBFL) 

Return code (cpcbrc) 

Save area address 

Save area id (bytes 4, 5, 7, and 8 of the module name if available) 
Address of the issuer of the macro (cpcall, cpexit, or cpwait) 
cpcb operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

cpcb word 3 (field wtdptr) 
cpcb word 4 (field cpcbph) 
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SSCP (RUPE) 

Entry: CI2 or C02 

vit Option: sscp 

Event: Requests (Part 2) 

vit Processing Module: istracsc 

Applies to: mvs t vm, vse 


The C12 and C02 trace records are continuations of the cn and coi entries. 



Byte (hex) Contents 

00-02 Record id: 

• C'ci 2 ’ for inbound processing 

• C'C02' for outbound processing 

03 Control block id = X' 54 1 

04 - 1B Fi rst 24 bytes of ru 
1C - IF Sense data or zero 
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CI2 or C02 


SSCP (NCSPL) 


0 

o 

o 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

l 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CI2 

C 

RDTE 


CPCB 











0 










or 


B 

STATE 

WTD 






















C02 

I 





























L 



D 






























Byte (hex) Contents 

00-02 Record id: 

• C‘ci 2 ' for inbound processing 

• C‘co2' for outbound processing 

03 Control block id = X' 60 1 

04-07 rdte state (in control block rpre). This value, a resource status code, 
is explained in VTAM Messages and Codes and in control block fsm, 
which is documented in VTAM Data Areas. 

08 - 0B cpcb wtd (first four bytes) 

0C-1F Zero 


SSCP (not RUPE or NCSPL) 



Byte (hex) 
00-02 

03 

04-IF 


Contents 
Record id: 

• C‘ci2’ for inbound processing 

• C‘C02’ for outbound processing 

Control block id (Control block ids are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 

Zero 
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SSCP (RUPE, NCSPL, or Not RUPE or NCSPL) 

Entry: CI3 or C03 

vit Option: sscp 

Event: Requests (Part 3) 

vit Processing Module: istracsc 

Applies to: mvs, vm, vse 

Part 3 of the cin or con record is for both format 0 and format 1 and contains the 
address of the istsib for the session, the istpcid, and the plu and slu names. 

Note: If this is the last cin or con entry, these are the plu and slu names as known 
in this network. If this entry is followed by ci4 or C 04 , these are just the plu and slu 
names. The ci4 or C 04 entry identifies the network. 


0 0 0 

0 

0 0 0 0 

00000000 

11111111 

11111111 

0 1 2 

3 

4 5 6 7 

89ABCDEF 

0 1 2 3 4 5 6 7 

89ABCDEF 

CI3 

0 

SIB 

PCID FOR THIS 

PLU NAME 

SLU NAME 

or 


ADDRESS 

REQUEST 



C03 







Byte (hex) Contents 

00-02 Record id: 

• C‘ci3’ for inbound processing 

• C'C03’ for outbound processing 

03 Zero 

04-07 sib address 

08 - OF pcid for this request 

10-17 plu name 

18-IF slu name 
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CI4 or C04 


SSCP (RUPE, NCSPL, or Not RUPE or NCSPL) 

Entry: CI4 or C04 

vit Option: sscp 

Event: Requests (Part 4) 

vit Processing Module: istracsc 

Applies to: ms, vr/*, vse 


Part 4 of the cin or con entry is for format 1 only. 


0 0 0 
0 1 2 

0 0 0 0 0 
3 4 5 6 7 

00000000 

89ABCDEF 

11111111 
0 1 2 3 4 5 6 7 

11111111 
8 9 A B C D E F 

CI4 

0 

PCID IN 

PLU NETID 

SLU NETID 

or 


PREVIOUS 



C04 


REQUEST 




Byte (hex) Contents 

00-02 Record id: 

• C‘ci4’ for inbound processing 

• C‘C04’ for outbound processing 

03-07 Zero 

08-OF pcid in previous request 

10- 17 plu network id 

18- IF slu network id 
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vse CONN 
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vse SHM Connect 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vse CONN 

CIO 

Connection 

ISTRACCI 

ISTTSC 1 R 

VSE 


This trace record is generated for x .21 short-hold mode attachments. It is written 
when a port is connected to a station. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CONN 


T 

C 

P 

S 

0 

CUA 

GROUP 


HALCB 


PUT 




0 


P 

0 





I 

F 

M 

H 





NCB 



ADDRESS 

ADDRESS 





E 







K 

S 

F 

S 





ADDRESS 













A 








M 

S 

I 































M 



























Byte (hex) 

00-03 

04 

05 

06 

07 

08 

09-0B 
0C-0F 
10-13 
14-17 
18 — 1B 
1C — ID 
IE — IF 


Contents 

Record id: C'conn’ 

Task identification key 

Connection finite state machine (fsm; see halcfsm in isthalcb for 
values) 

Port manager fsm (see halpmfsm in isthalcb for values) 
x.2i short-hold mode status indicator (see putflgi in istput) 

Zero 

Channel unit address of link 

Group network control block address (istgrpcb) 

Link network control block address (isthalcb) 

Physical unit table address (istput) 

Zero 

pu element add 
Zero 
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CPPG or CPPT (V3R1, V3R1.1, and V3R1.2) 


CPPURGE or CPPOST with EID or URC (Part 1, for V3R1, V3R1.1, and V3R1.2) 

Entry: CPPG or CPPT 

vit Option: sscp 

Event: cppurge or cppost Macro (Part 1) 

vit Processing Module: istracsc 

Control is Returned to: istcpcpp 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 

This trace record gives information about cppurge or cppost macroinstruction proc¬ 
essing. It may help you determine why i/o is outstanding or why an sscp request is 
failing. 

cppg and cppt are the complements of cpwt. Each cppt is preceded by a cpwt. But 
a cppg can post several events at once, as it may be concluding several cpwt 
entries. 


0 0 0 0 
0 12 3 

0 

4 

0 

5 

0 

6 

0 

7 

0 0 0 0 
8 9 A B 

0 0 0 0 
C D E F 

1111 
0 12 3 

111111111111 

456789ABCDEF 

CPPG 

I 

C 

T 

0 

LQAB 

DATA 

RETURN 

FIRST 12 BYTES OF EID 

or 

D 

0 

Y 

- 

ADDRESS 


ADDRESS 

or URC 

CPPT 


D 

P 

L 







E 

E 

E 




1 





N 






Byte (hex) Contents 

00-03 Record id: 

• C'cppg' for cppurge processing 

• C‘cppt’ for cppost processing 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 

05 Return code set by cppost or cppurge 

06 Type byte: 

• X'00' = urc was used for this macro 

• X'01 1 = Event id (eid) was used for this macro 

07 If type = X'00' (urc), zero. 

If type = X' 01' (eid), length of event id. (Wait state event ids are 
explained in VTAM Messages and Codes.) 

08- 0B Address of lqab for this macro 

0C-0F For mvs and vse, data operand specified by this macro. 

For vm, wredta in WRE 

10-13 Address of issuer of cppurge or cppost macro 

14- IF Type information: 

If type = X'00' (urc), urc up to 12 bytes 

If type = X' 01 1 (eid), eid up to 12 bytes. (Wait state event ids are 
explained in VTAM Messages and Codes.) 
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CPPURGE or CPPOST (Part 2, for V3R1, V3R1.1, and V3R1.2) 

Entry: CPP2 

vit Option: sscp 

Event: cppurge or cppost Macro (Part 2) 

vit Processing Module: istracsc 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record contains the rest of the event id for cppurge or cppost macroin¬ 
struction processing. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


CPP2 


ADDITIONAL EVENT IDENTIFIER FOR CPPOST/CPPURGE 
(if needed) 


Byte (hex) Contents 

00-03 Record id: C'cpp2’ 

04 - IF Event id (up to 28 bytes) 
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CPPG or CPPT (V3R2) 


CPPURGE or CPPOST for PVI or Non-PVI Event (Part 1, for V3R2) 

Entry: CPPG or CPPT 

vit Option: sscp 

Event: cppurge or cppost Macro (Part 1) 

vit Processing Module: istracsc 

Control is Returned to: istcpcpp 

Applies to: mvs (V3R2),vm (V3R2),vse (V3R2) 

This trace record gives information about cppurge or cppost macroinstruction proc¬ 
essing. It may help you determine why i/o is outstanding or why an sscp request is 
failing. 


cppg and cppt are the complements of cpwt. Each cppt is preceded by a cpwt. But 
a cppg can post several events at once, as it may be concluding several cpwt 
entries. 


G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

0 

G 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

i 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CPPG 


I 

C 

T 

0 

LQAB 


WREDATA 

WORK 


0PC 

IN 

SAVE 


SENSE 

or 



0 

0 

Y 

P 

ADDRESS 

IN WRE 

ELEMENT 

WORK 


AREA ID 

DATA 


CPPT 



D 

P 

T 









ADDRESS 

ELEMENT 

or 0 


or 

0 







E 

E 














or G 











Byte (hex) 

00-03 

04 


05 

06 


07 


08-0B 
0C-0F 
10-13 
14-17 


18 — IB 
1C-1F 


Contents 

Record id: 

• C'cppg’ for cppurge processing 

• C‘cppt for cppost processing 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 

Return code set by cppost or cppurge 
Type flags 

• B'00000000’ = urc, non-pvi event 

• B‘00000001 ’ = urc, pvi event 

• B‘00000010’ = eid, non-pvi event 

• B‘00000011 ’ = eid. pvi event 
Optional field 

• For cppg: Zero 

• For cppt mvs/370 vse: Zero 

• For cppt mvs/xa vm: 0 for find, 1 for dq, 2 for post 
lqab address 

Data field in istwre 
W ork element address 

cpcb operation code that indicates the original request for this work 
element or zero, cpcb operation codes are shown in 
Appendix D, "CPCB Operation Codes" on page 645. 

For pvi events, caller's save area id or 0 
For non- pvi events, save area id 
Sense data or zero 
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CPPURGE or CPPOST (Part 2, for V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPP2 

SSCP 

cppurge or cppost Macro (Part 2) 

ISTRACSC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the cppg or cppt (V3R2) trace record. 


CPP2 


RETURN 

ADDRESS 


RUPEURC or 0 


Byte (hex) 

00-03 
04-07 
08-18 
19 —IF 


Contents 

Record id: C‘cpp2’ 

Return address to issuer of the cppurge or cppost macroinstruction 

rupeurc or 0 

Zero 
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CPP3 (V3R2) 


CPPURGE or CPPOST (Part 3, for V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPP3 

SSCP 

cppurge or cppost Macro (Part 3) 
ISTRACSC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record contains part or all of the event id (eid) for cppurge or cppost 
macroinstruction processing. If an eid is less than 24 bytes long, only the bytes in 
the actual eid will be moved to the corresponding fields in the trace records. The 
leftover bytes will be set to zero. 


Note: This trace record is produced only when the wre points to an eid. 



Byte (hex) 

Contents 

00-03 

Record id: C'cpp3’ 

04-06 

Zero 

07 

Length of eid 

08 — IF 

First 24 bytes of eid 
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CPP4 (V3R2) 
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CPPURGE or CPPOST (Part 4, for V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPP4 

SSCP 

cppurge or cppost Macro (Part 4) 

ISTRACSC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record contains part or all of the ru for cppurge or cppost macroin¬ 
struction processing. It may help you determine why i/o is outstanding or why an 
sscp request is failing. If an ru is less than 24 bytes long, only the bytes in the 
actual ru will be moved to the corresponding fields in the trace records. The left¬ 
over bytes will be set to zero. 


Note: This trace record is produced only for pvi events where a rupe is available. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


CPP4 


FIRST 24 BYTES OF RU or 0 


Byte (hex) 

00-03 
04-IB 
1C — IF 


Contents 

Record id: C‘cpp4' 
First 24 bytes of ru 
Zero 
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CPRC 


CPRC (Parti) 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 

Applies to: 


CPRC 

SSCP 

cprc Macro (Part 1) 

ISTRACSC 

The module that issued the cprc macro (many pos¬ 
sible) 

MVS, VM„ VSE 


This trace record gives information about cprc macroinstruction processing. It is 
written when a vtam module issues a cprc macroinstruction to set a non-zero 
sense code in an rupe. 


This event is treated as an exception condition and is always traced, whether the 
sscp option is in effect or not. 


CPRC 


Q 

0 

0 

0 

0 

0 

9 

A 

B 

C 

D 

E 


RUPE 
ADDRESS 
or 0 


OPC IN 

THIS 

RUPE 


SENSE 

CODE 


1 

1 

1 

5 

6 



RUPE 

ORIGIN 

NETWORK 

ADDRESS 


1 

1 

1 

1 

1 

1 

9 

A 

B 

C 

D 

E 


RUPE 

DESTINATION 

NETWORK 

ADDRESS 


Byte (hex) 

00-03 

04 


05-07 
08-0B 
0C-0F 

10-13 
14-19 
1A — IF 


Contents 

Record id: C'cprc’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Zero 

Address of rupe for this macro, or 0 

cpcb operation code for rupe that indicates the original request for this 

RUPE 

Sense code 

Network address at origin 
Network address at destination 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 8. Using the VTAM Internal Trace 377 




CPR2 


CPRC (Part 2) 
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Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPR2 

SSCP 

cprc Macro (Part 2) 

ISTRACSC 

MVS, VM,VSE 


This trace record is a continuation of the cprc entry. 


CPR2 


0 

0 

0 

0 

0 

0 

0 

5 

6 

7 

8 

9 

A 

B 


RETURN 

ADDRESS 


0 

0 

0 

1 

D 

LU 

F 

0 


RUPEURC 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

5 

6 

7 

00 

9 

A 

B 

C 

D 

E 


0 


Byte (hex) 

Contents 

00-03 

Record id: C‘cpr2’ 

04-07 

Address of the issuer of the cprc macro 

08-18 

RUPEURC 

19 — IF 

Zero 
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CPWT (V3R1, V3R1.1, and V3R1.2) 


CPWAIT (Part 1, for V3R1, V3R1.1, and V3R1.2) 

Entry: CPWT 

vit Option: sscp 

Event: cpwait Macro (Part 1) 

vit Processing Module: istracsc 

Control is Returned to: istcpcpw 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record gives information about cpwait macroinstruction processing. It 
may help you determine why i/o is outstanding or why an sscp request is failing. 

This entry is eventually followed by a cppt entry (to resume processing) or a cppg 
entry (to purge the waiting task). Use the eid field to match corresponding entries. 


0 0 0 0 
0 12 3 

0 

4 

0 0 
5 6 

0 

7 

0 0 0 0 
8 9 A B 

0 0 0 0 
C D E F 

1111 
0 12 3 

1111 
4 5 6 7 

11111111 

89ABCDEF 

CPWT 

I 

0 

E 

LQAB 

WREDATA 

WORK 

0PC IN 

FIRST 8 BYTES 


D 


I 

ADDRESS 

IN WRE 

ELEMENT 

WORK 

OF CPCBURC 



1 

1 

1 

D 



ADDRESS 

ELEMENT 



L 

N 


Byte (hex) 

00-03 

04 


05-06 

07 

08-0B 
0C-0F 
10-13 


14-17 


18 — IF 


Contents 

Record id: C‘cpwt’ 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Zero 

Length of event id 

Address of lqab for this cpwait macro 
Data field in istwre when cpwait is performed 
Work element address: 

Zero for asynchronous cpwait 
Non-zero for synchronous cpwait 

cpcb operation code that indicates the original request for this work 
element (cpcb operation codes are shown in Appendix D, “CPCB 
Operation Codes” on page 645.) 
cpcburc (first 8 bytes) 
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CPWAIT (Part 2, for V3R1, V3R1.1, and V3R1.2) 

Entry: CPW2 

vit Option: sscp 

Event: cpwait Macro (Part 2) 

vit Processing Module: istracsc 

Applies to: mvs(V 3R1.1 andV3R1.2), vm(V 3R1.1 andV3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record is a continuation of the cpwait trace record. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


CPW2 


RETURN 

ADDRESS 


FIRST 24 BYTES OF EID 


Byte (hex) 

00-03 
04-07 
08 — IF 


Contents 

Record id: C'cpw2’ 

Address of issuer of cpwait macro 

Event id (up to 24 bytes). See VTAM Messages and Codes for a list of 

EIDS. 
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CPWT (V3R2) 


CPWAIT for PVI or Non-PVI Events (Part 1, for V3R2) 

Entry: CPWT 

vit Option: sscp 

Event: cpwait Macro (Part 1) 

vit Processing Module: istracsc 

Control is Returned to: istcpcpw 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 

This trace record gives information about cpwait macroinstruction processing. It 
may help you determine why i/o is outstanding or why an sscp request is failing. 


This entry is eventually followed by a cppt entry (to resume processing) or a cppg 
entry (to purge the waiting task). Use the eid field to match corresponding entries. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

CPWT 


I 

0 

T 

G 

LQAB 


WREDATA 

WORK 


OPC 

IN 

SAVE 



0 






D 


Y 


ADDRESS 

IN WRE 

ELEMENT 

WORK 


AREA ID 











P 










ADDRESS 

ELEMENT 

or 0 












E 














or 0 











Byte (hex) 

Contents 

00-03 

Record id: C'cpwt’ 

04 

id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

05 

Zero 

06 

Type flags 

• B'00000001’ = PVi event 

• B'OOOOOOOO’ = non-pvi event 

07 

Zero 

08-0B 

lqab address for this cpwait macro 

Li. 

O 

1 

o 

o 

Data field in istwre when cpwait is performed 

10-13 

Work element address 

14-17 

cpcb operation code that indicates the original request for this work 
element or zero (cpcb operation codes are shown in 

Appendix D, "CPCB Operation Codes” on page 645.) 

18 — 1B 

For pvi event, caller's save area id or zero 

For non- pvi event, save area id 

1C — 1F 

Zero 
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CPWAIT (Part 2, for V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPW2 

SSCP 

cpwait Macro (Part 2) 

ISTRACSC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the cpwait trace record. 


CPW2 


RETURN 

ADDRESS 


RUPEURC or Q 


Byte (hex) 

Contents 

00-03 

Record id: C‘cpw2’ 

04-07 

Return address to issuer of the cpwait macroinstruction 

08-18 

rupeurc or 0 

19— IF 

Zero 
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CPW3 (V3R2) 


CPWAIT (Part 3, for V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


CPW3 

SSCP 

cpwait Macro (Part 3) 

ISTRACSC 

mvs (V3R2), vm (V3R2),vse (V3R2) 


This trace record is a continuation of the CPW2 trace record. If an eid is less than 24 
bytes long, only the bytes in the actual eid will be moved to the corresponding 
fields in the trace records. The leftover bytes will be set to zero. 


Note: This trace record is produced only when the wre points to an eid event. 



Byte (hex) 

Contents 

00-03 

Record id: C‘cpw3’ 

04-06 

Zero 

07 

Length of eid 

08 — 1F 

First 24 bytes of eid 
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CPWAIT (Part 4, for V3R2) 

Entry: CPW4 

vit Option: sscp 

Event: cpwait Macro (Part 4) 

vit Processing Module: istracsc 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 

This trace record is a continuation of the CPW3 trace record. If an ru is less than 24 
bytes long, only the bytes in the actual ru will be moved to the corresponding fields 
in the trace records. The leftover bytes will be set to zero. 

Note: This trace record is produced only for pvi events where a rupe is available. 

00000000000000001111111111111111 

0123456789ABCDEF0123456789ABCDEF 

CPW4 FIRST 24 BYTES OF RU or 0 

Byte (hex) Contents 

00-03 Record id: C'cpw4’ 

04 -1B Fi rst 24 bytes of ru 

1C — IF Zero 
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VSE DISC 


vse SHM Disconnect 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vse DISC 

CIO 

Disconnection 

ISTRACCI 

ISTTSCVI 

VSE 


This trace record is generated for x.21 short-hold mode attachments. It is written 
when a port is disconnected from a station. 


0 

0 

G 

G 

G 

G 

G 

Q 

Q 

G 

Q 

G 

G 

Q 

G 

Q 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

DISC 


T 

C 

P 

S 

G 

CUA 

GROUP 


HALCB 


PUT 






G 








I 

F 

M 

H 





NCB 



ADDRESS 

ADDRESS 













K 

S 

F 

S 





ADDRESS 






















M 

S 

I 































M 



























Byte (hex) 

00 - 

03 

04 


05 


06 


07 


08 


09- 

0B 

oc- 

-OF 

10 - 

13 

14- 

17 

18- 

IF 


Contents 

Record id: C'disc’ 

Task identification key 

Connection finite state machine (fsm; see halcfsm in isthalcb for 
values) 

Port manager fsm (see halpmfsm in isthalcb for values) 
x.21 short-hold mode status indicator (see putflgi in istput) 

Zero 

Channel unit address of link 

Group network control block address (istgrpcb) 

Link network control block address (isthalcb) 

Physical unit table address (istput) 

Zero 
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DISP (V3R1, V3R1.1, and V3R1.2) 
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PAB Dispatch (Part 1, for V3R1, V3R1.1, and V3R1.2) 

Entry: DISP 

vit Option: pss 

Event: pab Dispatch (Part 1) 

vit Processing Module: istracps 

Control is Returned to: istapcpd 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 

The disp entry marks the beginning of a pab dispatch, which is vtam's major "unit of 
work." This unit exists until terminated by an exit entry. While processing, it may 
wait for other events to complete (wait). It resumes processing with a resm entry. 
The unit may be interrupted by a higher priority task and continue when that task is 
finished. 


To correlate all events associated with this unit, look for the rph address, which is 
in many trace records, and match it to the rph address in the disp trace record. 
This unit has exclusive use of that rph until exit. 


0 0 0 0 

0 

0 

0 0 

0 0 0 0 

0 0 0 0 

1111 

1111 

1111 

1111 

0 12 3 

4 

5 

6 7 

8 9 A B 

C D E F 

0 12 3 

4 5 6 7 

8 9 A B 

C D E F 

DISP 

I 

C 

P 

PST 

PAB 

WORK 

PAB 

MODULE 

RPH 


D 

B 

A 

ADDRESS 

ADDRESS 

ELEMENT 

CHAIN 

NAME 

ADDRESS 



I 

B 



QUEUE 

FIELD 

or DVT 




D 

0 





ADDRESS 



F 


Byte (hex) Contents 

00-03 Record id: C'disp’ 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 

05 Control block id of work element (Control block ids are shown in 

Appendix E, "Storage and Control Block ID Codes" on page 657.) 
06-07 pab offset 

08-0B pst address 

0C-0F pab address 

10- 13 Address of work element currently being dispatched 
14- 17 pab chain field 

18- IB Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the first 
module to get control), or pab dvt address (high order bit of X' 18' = 0) 
1C-IF rph address. The rph address in location 1C-IF appears in many 

other vit entries associated with this particular dispatch. Use this rph 
address to group events associated with this dispatch. The rph is 
freed or reused after an exit trace record. 
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DIS2 (V3R1, V3R1.1, and V3R1.2) 


PAB Dispatch (Part 2, for V3R1, V3R1.1, and V3R1.2) 

Entry: DIS2 

vit Option: pss 

Event: pab Dispatch (Part 2) 

vit Processing Module: istracps 

Applies to: mvs(V3R1.1 andV3R1.2), vm(V3R1.1 andV3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record is a continuation of pab Dispatch (Part 1). 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

DIS2 


WORK 


F 




0 







PAB 

EXTENSION 

or 0 








ELEMENT 

L 




























ADDRESS 

A 




























or 0 


G 
































S 

























Byte (hex) 

00-03 

04-07 


08 

09-OF 
10 — IF 


Contents 

Record id: C'dis2’ 

Address of work element, or zero. Zero means either that there was 
no work element, or that this process queues work elements some¬ 
where other than the pab. 

Flag field (pabflags) 

Zero 

pab extension (pabxtnsn) if this is an extended pab. 
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PAB Dispatch (V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


DISP 

PSS 

pab Dispatch 

ISTRACPS 

ISTAPCPD 

mvs(V3R2), vm(V3R2), vse (V3R2) 


Each pab is identified by a unique index number, vtam uses this number to find the 
called module and then creates a vit entry for it. 


The disp entry marks the beginning of a pab dispatch, which is vtam's major “unit of 
work.” This unit exists until terminated by an exit entry. While processing, it may 
wait for other events to complete (wait). It resumes processing with a resm entry. 
The unit may be interrupted by a higher priority task and continue when that task is 
finished. 


To correlate all events associated with this unit, look for the rph address, which is 
in many trace records, and match it to the rph address in the disp trace record. 
This unit has exclusive use of that rph until exit. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

DISP 


I 

C 

F 

0 

PST 



PAB 



LAST 


CURRENT 

MODULE 

RPH 







D 

B 

L 

- 

ADDRESS 

ADDRESS 

WORK 


WORK 


NAME 


ADDRESS 






I 

A 

w 









ELEMENT 

ELEMENT 

or DVT 










D 

G 

E 









ADDRESS 

ADDRESS 

ADDRESS 












Q 


























Byte (hex) 

00-03 

04 


05 

06 

07 

08-0B 
0C-0F 
10-13 
14-17 
18 — IB 

1C — 1F 


Contents 

Record id: C'disp’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

Control block id of work element (Control block ids are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 

Flag field (pabflags) 

Zero, or pab work element queue level dispatched for vary extended 
PABS 

pst address 
pab address 

Address of work element most recently queued to the pab 
Address of work element currently being dispatched 
Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the first 
module to get control), or pab dvt address (high order bit of X 1 18' = 0) 
rph address. The rph address in location 1C - IF appears in many 
other vit entries associated with this particular dispatch. Use this rph 
address to group events associated with this dispatch. The rph is 
freed or reused after an exit trace record. 


388 


VTAM Diagnosis 


LY30-5601-1 ©Copyright IBM Corp. 1984, 1989 




“Restricted Materials of IBM” 

Licensed Materials - Property of IBM 


DSCD 


Discarded PIU Buffer (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


DSCD 

PIU 

Discarded piu buffer (Part 1) 

ISTRACOT 

ISTTSCUD 

VSE (V3R2), MVS, VM 


This trace record is written when vtam'stsc utility discard routine, isttscud, dis¬ 
poses of piu buffers because of an error condition. The reason code and module 
identifier can be used to explain the reason for the discard. This entry is treated as 
an exception condition and is always traced, regardless of the vit options specified, 
if the vit is active. 


0 

0 

0 

G 

Q 

G 

G 

G 

G 

G 

G 

G 

Q 

G 

Q 

G 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

G 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

DSCD 


I 

REASN 

TSCB 







2G 

BYTES 

OF PIU 











D 

CODE 

ADDRESS 






















Byte (hex) 

00-03 

04 


05-07 

08-0B 
0C-1F 


Contents 

Record id: C'dscd' 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Discard reason code in hex. (piu discard reason codes are explained 
in Appendix F, “PIU Discard Reason Codes” on page 661.) 

Address of tscb 

First 20 characters of the piu. 
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Discarded PIU Buffer (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


DSC2 

PIU 

Discarded piu buffer (Part 2) 
istracot 

vse(V3R2), mvs VM 


This trace record is a continuation of the dscd entry. 


G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


DSC2 


24 MORE CHARACTERS OF THE PIU 


MODULE 

ID 


Byte (hex) 

00-03 
04 — 1B 
1C — IF 


Contents 

Record id: C‘dsC2‘ 

24 more characters of the piu 

id of the module that is discarding the piu 
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ERP 


MVS 


MVS 


Error Recovery Procedures 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


mvs ERP 

CIO 

Error Recovery 
ISTRACCI 

ISTZBMOJ for LDNCB, Or ISTZBMOK for ICNCB 
MVS 


This trace record is written during error recovery for channel i/o. 

• erpi is generated for communication controllers and local sna cluster control¬ 
lers. 

• erpl is generated for local non-SNA cluster controllers. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

ERPI 


I 

S 


0 


CUA 

NCB 



FLAG 


F 

C 

1 

S 




CSW 




or 



D 

T 







ADDRESS 

BYTES 

L 

0 

E 









ERPL 



A 















A 

D 

N 














T 















G 

E 

S 














E 

















E 










Byte (hex) 

00-03 


04 

05 

06-08 
09-0B 
0C-0F 
10-13 
14 


15 

16-17 
18— IF 


Contents 

Record id: 

C'erpi' for ICNCB 
C'ERPL’ for LDNCB 

Address space id (or zero if address space id is greater than X'FF') 
Link station state (see ncblnkst) 

Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Flag byte as follows: 

Bit Meaning 

.. 1. Exception condition occurred (iosex flag is on) 

...1 _ Error routine is in control (ioserr flag is on) 

i/o completion code: ioscod 
Sense data in iossns 
Channel status word from iosb 
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vm Error Recovery Procedures (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vm ERP 

CIO 

Error Recovery (Part t) 

ISTRACCI 

ISTTSCZZ 

VM 


This trace record is written during error recovery for channel i/o. 

• erpb is generated for error recoveries at the channel interface for a bsc line 
attached to the communication adapter. 

• erph is generated for error recoveries at the channel interface for an sdlc line 
attached to the communication adapter. 

• erpi is generated for communication controllers and local sna cluster control¬ 
lers. 


• erpl is generated for local non-SNA cluster controllers. 

• erpx is generated for channel-to-channel-attached hosts. 
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vmERP 


Byte (hex) 

00-03 


04 

05 

06-08 
09-OB 
OC-OF 
10-13 

14 

15 

16-17 
18 — IF 


Contents 

Record id: 

C'erpb’ for BSCLB 
C'ERPH’ for HALCB 
C’ERPI' for ICNCB 
C'ERPL’ for LDNCB 
C'erpx' for XCNCB 
Machine and task io 

Link finite state machine (lfsm) or link station state (see ncblnkst) 
Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Error code (ercod) in ncb or zero 
Return code or zero 
ncb sense data in ncbsense or zero 
Channel status word from ncb 
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vm Error Recovery Procedures (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vm ERP2 

CIO 

Error Recovery (Part 2) 

ISTRACCI 

VM 


This trace record is written during error recovery for channel i/o. It is a continua¬ 
tion of the erpb or erph trace entry. 


ERP2 


0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 


DEVICE-DEPENDENT INFORMATION 


0 


Byte (hex) 

00-03 
04-07 
08 — 1C 
ID — IF 


Contents 

Record id: C‘erp2’ 

Zero 

Device-dependent information shown below 
Zero 


For sdlc links (ncbtype = 09): 

08 Link error retry limit 

09 Error retry count 

0A Connection finite state machine 

0B Retry operation code 

0C-0F ccw address 

10 Sense byte 1 

11-12 ncb sense data area 

13— 1C Zero 


For bsc links (ncbtype = 0A): 


08-0B 

Zero 

11-12 

Sense data from ncbsense 

13 

Error code (ncbercod) 

14 — 1C 

Zero 
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vse ERP 


vse Error Recovery Procedures (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vse ERP 

CIO 

Error Recovery (Part 1) 

ISTRACCI 

SSABERV1 

VSE 


This trace record is written during error recovery for channel i/o. 

• erpb is generated for error recoveries at the channel interface for a bsc line 
attached to the communication adapter. 

• erph is generated for error recoveries at the channel interface for an sdlc line 
attached to the communication adapter. 

• erpi is generated for communication controllers and local sna cluster control¬ 
lers. 

• erpl is generated for local non-SNA cluster controllers. 
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Byte (hex) 
00-03 


04 

05 

06 

07-08 
09-OB 
0C-0F 
10-13 

14 

15 

16-17 
18 — IF 


Contents 

Record id: 

C'ERPB’ for BSCLB 
C'ERPH’ for HALCB 
C'ERPI' for ICNCB 
C'ERPL’ for LDNCB 
Task id 

Link finite state machine (lfsm) or link station state (see ncblnkst) 

Error action (eract) or zero 

Zero 

Channel device name in EBCDIC (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Error code (ercod) in ncb or zero 
Return code or zero 
ncb sense data in ncbsense or zero 
Channel status word from ncb 
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vse ERP2 


vse Error Recovery Procedures (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vse ERP2 

CIO 

Error Recovery (Part 2) 

ISTRACCI 

VSE 


This trace record is written during error recovery for channel i/o. It is a continua¬ 
tion of the erpb or erph trace entry. 


ERP2 


0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 


DEVICE-DEPENDENT INFORMATION 


0 


Byte (hex) 

00-03 
04-07 
08 — 1C 
1D — IF 


Contents 

Record id: C*erp 2 ’ 

Zero 

Device-dependent information shown below 
Zero 


For sdlc links (ncbtype = 09): 

08 Link error retry limit 

09 Error retry count 

0A Connection finite state machine 

0B Retry operation code 

0C-0F ccw address 

10 Sense byte 1 

11 — 12 ncb sense data area 

13— 1C Zero 


For bsc links (ncbtype = OA): 


08-0B 

Zero 

11-12 

Sense data from ncbsense 

13 

Error code (ncbercod) 

14 — 1C 

Zero 
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vm vse CIO Error Recovery (V3R1.2 and Later) 

Entry: vm vse ERP 

vit Option: cio 

Event: Start i/o 

vit Processing Module: istractr (snap trace recording routine) 

Control is Returned to: istapces 

Applies to: VM VSE (V3R1.2 and later) 

This trace record provides error recovery information for an x.25 port. An erp entry 
is built on every entry to erp for an x.25 port, whether for an error or for counter 
overflow or shutdown recording. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a control link channel program and a buffer pool channel program. 



Byte (hex) 

00-02 

03 


04 

05-07 

08 

09-0B 
0C-0F 
10-13 
14-15 
16-17 
18—IF 


Contents 

Record id: C‘erpa’ 

Type: 

0C = Control link channel program 
0D = Buffer pool channel program 
Machine and task id 

Channel device name in ebcdic (either a cua or device number) 
Zero 

ncb address 

Virtual caw 

Flag bytes (ncbflags) 

Error code (ercod) in ncb or zero 
ncb sense data in ncbsense or zero 
Zero 


398 VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 




ESC 


"Restricted Materials of IBM" 

Licensed Materials - Property of IBM 


TPESC 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


ESC 

ESC 

tpesc Macro 

ISTRACOT 
ISTESC01 
MVS, VM, VSE 


This trace record identifies the address of the next routine to get control in a desti¬ 
nation vector table (dvt). The pab address identifies the process. Using the rph 
address, you can correlate this trace record to the disp entry to find when the 
process was dispatched. 


ESC 


P 

A 

B 

0 

F 


DISP 

ADDRESS 


PAB 

ADDRESS 


RETURN 

ADDRESS 


RPH 

WORK 

ELEMENT 


MODULE 
NAME 
or DVT 
ADDRESS 


RPH 

ADDRESS 


Byte (hex) 

Contents 


00-03 

Record id: C‘esc’ 


04 

id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 


05 

Zero 


06-07 

pab offset 


m 

O 

l 

co 

o 

Dispatch address from dvt 


0C-0F 

pab address 


10-13 

Address of the issuer of the tpesc macro 


14-17 

rph work element 


18 — IB 

Module name abbreviation (bytes 4, 5, 7, and 8 of the name of 

the next 


module to get control), or pab dvt address (high order bit of X' 

18’ = 0) 

1C — IF 

rph address 
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TPEXIT 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


EXIT 

PSS 

tpexit Macro 
ISTRACPS 
ISTAPCTX 
MVS, VM, VSE 


This trace record identifies a vtam process (pab) that has finished executing. The 
pab is rescheduled if more work elements are waiting to be processed. 

In most cases, the rph (whose address is in location 1C- IF) is freed or reused 
after this entry. The two exceptions are the front endmessage pab (atcfempb — 
module istcfcfg) and the sms dynamic expansion dypab (atcpxpab — module 
istorfpx). These two pabs have dedicated rphs that are not used for anything else. 


This entry is the complement of disp. An exit should eventually follow every disp. 
Use the rph address to correlate the entries. 


EXIT 


P 

A 

B 

0 

F 


PST 

ADDRESS 


PAB 

ADDRESS 


RETURN 

ADDRESS 


WORK 

ELEMENT 

QUEUE 


MODULE 
NAME 
or DVT 
ADDRESS 


RPH 

ADDRESS 


Byte (hex) 

00-03 

04 


05 

06-07 
08-0B 
0C-0F 
10-13 
14-17 
18 — IB 


1C — IF 


Contents 

Record id: C'exit’ 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 

tpexit options (see field apnflgs in control block istapnop in VTAM 
Data Areas) 

pab offset, or zero if no pab (see note) 
pst address 

pab address, or zero if no pab (see note) 

Address of the issuer of the tpexit macro 

pab work element queue, or zero if no pab (see note) 

Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 
module to get control), or pab dvt address (high order bit of X' 18' = 

0), or zero if no pab (see note) 
rph address 


Note: There is no pab if the running process has already freed the major control 
block that contains the pab. 
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FBLK 


FREEBLK 

Entry: FBLK 

vit Option: sms 

Event: freeblk Macro 

vit Processing Module: istracsm 

Control is Returned to: istcpcsm 

Applies to: mvs, vmj, vse 

This trace record provides the status of each freeblk request issued by vtam com¬ 
ponents. 

The freeblk macro is the complement of the getblk macro, freeblk must release 
the storage obtained by getblk. Each gblk entry should eventually have a corre¬ 
sponding fblk entry. 


If the return code is non-zero, this entry is generated whether the sms option is in 
effect or not. This event is treated as an exception condition, and therefore, is 
traced whenever the vit is active. 



Byte (hex) Contents 

00 — 03 Record id: C'fblk’ 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 Zero 

06 Storage pool type (in hex): 

Pool Contains 
00 Private rupe 
01 Common rupe 
02 vtam private sib 

03 SSCP FMCB 

04 Not used 
05 DVT/EPT 
06 Dynamic cdrsc 
07 ACDEB/APPCB 
08 HSQH 
09 ERTE 
0A wre and eid 
0B fmcb extension 
0C sib extension 
0D RSQE 
0E UECB/VRPL 
OF IOBLOCK 
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10 SRTE 

11 NetView trace element 

12 UTILPOOL/UTILPVTS 

13 Message timer blocks (dmtsq) 

14 vtam private powe 

15 Common powe 

16 PULURDTE 

17 PAQ 

18 RAQ 

19 CPWAPVT 
1A ERICPOOL 
IB SIBIX 

1C CDAJSCP 
ID GWNAJSCP 
IE IOSIB 
IF DSSIB 

20 UTILPVTL 

21 UTILCSAS 

22 UTILCSAL 

23 AMU 

24 HSICB 

25 LMHDR/LME/LMM 

26 SAB/NSI 

27 RAB 

28 PRIDBLK 

29 PRIDQAB 
2A OCB/NACP 
2B CPWACSA 

07 Zero 

08 - OB Address of block freed (or zero if freeblk failed) 

0C - OF Address of storage pool anchor block (spanc) 

10 — 13 Address of the issuer of the freeblk macro 

14-17 Length of storage freed 

18 —IB Caller of utility routine or zero. If the freeblk macro was issued from 
a utility routine, then the address of the utility's caller is placed here. 

A zero address means that the macro was issued directly by the caller 
(see return address) without a utility routine. 

1C-IF Return code 
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GETBLK 


Entry: GBLK 

vit Option: sms 

Event: getblk Macro 

vit Processing Module: istracsm 

Control is Returned to: istcpcsm 

Applies to: mvs,vm,vse 

This trace record provides the status of each getblk request issued by vtam com¬ 
ponents. 


The freeblk macro is the complement of the getblk macro, freeblk must release 
the storage obtained by getblk. Each gblk entry should eventually have a corre¬ 
sponding fblk entry. 


If the return code is non-zero, this entry is generated whether the sms option is in 
effect or not. It is treated as an exception condition and is always traced, regard¬ 
less of the sms option, if the vit is active. 


0 

0 

0 

0 

1 

2 


GBLK 


0 

0 

0 

0 

7 

co 

9 

A 


G 

G 

G 

G 

1 

1 

1 

C 

D 

E 

F 

G 

1 

2 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

4 

5 

6 

7 

CO 

9 

A 

B 

C 

D 

LU 


I 

D 


STORAGE 

ADDRESS 


or 0 


ADDRESS 

OF 

SPANC 


RETURN 

ADDRESS 


LENGTH 

OF 

STORAGE 

REQUEST 


CALLER 

OF 

UTILITY 
or 0 


RETURN 

CODE 


Byte (hex) 

00-03 

04 


05 

06 


Contents 

Record id: C'gblk' 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 
Zero 

Buffer pool type (in hex): 

Pool Contains 
00 Private rupe 
01 Common rupe 
02 vtam private sib 

03 SSCP FMCB 

04 Not used 
05 dvt/ept 
06 Dynamic cdrsc 
07 ACDEB/APPCB 
08 HSQH 
09 ERTE 
0A wre and eid 
0B fmcb extension 
0C sib extension 
0D RSQE 
0E UECB/VRPL 
OF IOBLOCK 
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10 SRTE 

11 NetView trace element 

12 UTILPOOL/UTILPVTS 

13 Message timer blocks (dmtsq) 

14 vtam private powe 

15 Common powe 

16 PULURDTE 

17 PAQ 

18 RAQ 

19 CPWAPVT 
1A ERICPOOL 
IB SIBIX 

1C CDAJSCP 
ID GWNAJSCP 
IE IOSIB 
IF DSSIB 

20 UTILPVTL 

21 UTILCSAS 

22 UTILCSAL 

23 AMU 

24 HSICB 

25 LMHDR/LME/LMM 

26 SAB/NSI 

27 RAB 

28 PRIDBLK 

29 PRIOQAB 
2A OCB/NACP 
2B CPWACSA 

07 Zero 

08-0B Address of block obtained (or zero if getblk failed) 

0C-0F Address of storage pool anchor block (spanc) 

10 — 13 Address of the issuer of the getblk macro 
14-17 Length of storage request 

18 —IB Caller of utility routine or zero. If the getblk macro was issued from a 

utility routine, then the address of the utility's caller is placed here. 

1C-IF Return code 
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HIO 


Halt I/O 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


HIO 

CIO 

Halt i/o 
ISTRACCI 
ISTTSCLR 
MVS, VM, VSE 


This trace record is written when a Halt i/o svc is issued to end a currently exe¬ 
cuting channel program. This should be followed shortly by an interrupt (int) entry. 
Be sure to match the cuas in the hio and int entries to be sure they are for the 
same device. See VTAM Data Areas for a description of the ncb and xcncb fields. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

Q 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

HIOB 


I 

S 

M 

0 

CUA 

NCB 



FLAG 







0 






HIOH 


D 

T 

0 





ADDRESS 

BYTES 













HIOX 



A 

D 






























T 

I 






























E 

D 


























Byte (hex) 

00-03 

04 


05 


06-07 

08 

09-0B 
0C-0F 
10-13 
14— IF 


Contents 

Record id: C'hiob’, 'hioiT, or ‘hiox’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X ‘ FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

For hiob, link station state (bsclkfsm) 

For hioh, link station state (hallfsm) 

For hiox, station state (xcnssfsm) 

Module id (last 2 characters of tsc module name) 

Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Zero 
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vm vse Halt I/O (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE HIOP 

CIO 

Start i/o 

ISTRAC6T 

ISTTSC6L Or ISTTSC6P 

vm (V3R1.2 and later), vse (V3R2) 


This trace record is created when a Halt i/o svc is issued to end a currently exe¬ 
cuting channel program. This may be followed by an interrupt (int) entry. Match 
the cuas in the hio and int entries to be sure they are for the same device. A Halt 
i/o svc is issued against each of four cuas during initialization or termination of the 
Token-Ring Subsystem. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

HIOP 


I 

C 

M 

0 

CUA 

NCB 



P 







0 











D 

P 

0 





ADDRESS 

D 




















F 

D 









A 




















S 

I 









T 




















M 

D 









A 
















Byte (hex) 

00-03 

04 

05 


06-07 

08 

09-0B 
0C-0F 
10 


Contents 

Record id: C'hiop’ 

Machine and task id 
Channel program fsm 
00 Reset 
01 Sense id 
02 Interrupt port 
03 Control port 
04 Running 
05 Sense 

06 Orderly halt (hltc) 

07 Termination 
08 Shutdown 

Module id (last 2 characters of tsc module name) 

Zero 

Channel device name in ebcdic (either a cua or device number) 
ncb address 
Port state (pdata) 

00 Reset 
01 Halt 

02 Halt complete 
03 Sense id 
04 Sense id complete 

05 Interrupt pending 

06 Active 
07 Sense 
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vm vse HIO (V3R1.2 and later) 


i 1 Port type (pdata) 

00 Interrupt 
01 Control 
02 Inbound 
03 Outbound 
12-1F Zero 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Chapter 8. Using the VTAM Internal Trace 407 



mvs INT 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


mvs interrupt 
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Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


mvs INT 

CIO 

Channel Interrupt 
istracci 

ISTTSCLC 

MVS 


This trace record is written when a channel program interrupt occurs. 

Every int entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and int entries. The sio entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the ncb fields. See the diagnostic 
manuals for your operating system for a description of the ios fields. 


0 

0 

0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

INTI 


I 

S 

E 

0 

CUA 

NCB 



FLAG 


F 

C 

S 

0 




CSW 




INTL 


D 

T 

0 






ADDRESS 

BYTES 

L 

0 

E 

r 









INTX 



A 

P 














A 

D 

N 















T 

C 














G 

E 

S 

0 














E 

D 
















E 











Byte (hex) 

00-03 


04 

05 

06 

07-08 
09-0B 
0C-0F 
10-13 
14 


15 

16-17 
18 — IF 


Contents 

Record id: 

C'lNTl’ for ICNCB 
C'INTL’ for LDNCB 
C'lNTX’ for XCNCB 

Address space id (or zero if address space id is greater than X 1 FF') 
Link station state (ncblnkst) for icncb and ldncb 

Station state (xcnssfsm) for xcncb 

Ending operation code 

Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Flag byte as follows: 

Bit Meaning 

1. Running in disabled interrupt exit (iosdie is not zero) 

.1. ERP work area address exists (ioserp is not zero) 

.. 1. Exception condition (iosex flag is on) 

...1 _ Error routine in control (ioserr flag is on) 

i/o completion code: ioscod 

Sense data in iossns if this was a sense channel program: otherwise, 
zero 

Channel status word from iosb. 
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VM 


INT 


vm Interrupt (Part 1) 

Entry: vm INT 

vit Option: cio 

Event: Channel Interrupt (Part 1) 

vit Processing Module: istracci 

Control is Returned to: isttsclc 

Applies to: vm 

This trace record is written when a channel program interrupt occurs. 

Every int entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and int entries. The sio entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the ncb fields. See the diagnostic 
manuals for your operating system for a description of the 10 s fields. 



Byte (hex) Contents 

00-03 Record id: 

C'lNTB’ for BSCTYPE 
C‘INTH' for HALTYPE 
C‘lNTf for ICNCB 
C‘INTL’ for LDNCB 
C‘intx' for XCNCB 
04 Machine and task id 
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05 For intb and inth, link finite state machine (lfsm) 

For inti and intl, link station state (ncblnkst) 

For intx, station state (xcnssfsm) 

06 Ending operation code or zero 

07-08 Zero 

09-0B Channel device name in ebcdic (either a cua or device number) 

0C-0F ncb address 

10-13 FI ag by tes (ncbflags) 

14 Flag byte as follows, or zero 

Bit Meaning 

1. Running in disabled interrupt exit (iosdie is not zero) 

.1. ERP work area address exists (ioserp is not zero) 

.. 1. Exception condition (iosex flag is on) 

... 1 .... Error routine in control (ioserr flag is on) 

15 i/o completion code: ioscod 

16-17 ncb sense data in ncbsense if this was a sense channel program; oth¬ 
erwise, zero 

18 -1F Channel status word from ncb. 
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vm INT2 


vm Interrupt (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vm INT2 

CIO 

Channel Interrupt (Part 2) 
ISTRACCI 

VM 


This trace record is a continuation of the int entry. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

INT2 



0 



DEVICE- 

-DEPENDENT 








0 

















INFORMATION 

















Byte (hex) 

00-03 
04-07 
08-13 
14 — IF 


Contents 

Record id: C‘int2’ 

Zero 

Device-dependent information shown below 
Zero 


For sdlc links (ncbtype = 09): 

08 Return code 

09 Buffer offset (sploffst) 

0A sdlc station address (spladdr) 

0B Control flag (splctlfg) 

0C Current sdlc number of last l-frame sent (splnscur) 

0D Last acknowledged l-frame (splnsack) 

0E Next l-frame to be received (splnracc) 

OF Command-in field (scxcmdin) 

10 Count of frames sent and acknowledged (scxcfrs) 

11 SCXCRBUF 

12-13 Exception flags and exception code (scxexfcd) 

For bsc links (ncbtype = 0A): 

08 First selection character (bscseli) 

09 First device address (bscdevi) 

0A Index of bpl entry for which input data was received (bscpesv) 

0B Device address from which input data was received (bscdevsv) 

0C Index for last station for which there was output data (bscisod) 

0D First response byte (bscrspai) 

0E Second response byte (bscrspa2) 

OF Last block type received (bsclbr) 

10 Current acknowledgment (bscaltak) 

11 Error retry count (bscrcnt) 

12 Connection manager flags (bsccmio) 

13 bsc flags (bscflags) 
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VM 


vse interrupt (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE INT 
CIO 

Start i/o 
ISTRAC6T 
ISTTSC6E 

vm (V3R1.2 and later), vse (V3R2) 


This trace record is created when a channel program interrupt occurs. 


If the int entry signals the completion of a channel program, it has a previously 
issued sio entry, although it may have been issued some time ago. Use the cua 
field to correlate sio and int entries. The sio entry provides additional information 
about this completing channel program. If the cua field contains the address speci¬ 
fied on the port statement, this int entry may not be related to an sio entry. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

INTP 


I 

C 


0 


CUA 

NCB 



P 

0 

S 

C 

S 

0 


ENDING CSW 






D 

P 







ADDRESS 

D 



T 

0 

E 















F 











A 



I 

D 

N 















S 











T 



M 

E 

S 















M 






_ 





A 





E 











Byte (hex) 

00-03 

04 

05 


06-08 
09-0B 
0C-0F 
10 


Contents 

Record id: C'intp* 

Machine and task id 
Channel program fsm 
00 Reset 
01 Sense id 
02 Interrupt port 
03 Control port 
04 Running 
05 Sense 

06 Orderly halt (hltc) 

07 Termination 
08 Shutdown 
Zero 

Channel device name in ebcdic (either a cua or device number) 
ncb address 
Port state (pdata) 

00 Reset 
01 Halt 

02 Halt complete 
03 Sense id 
04 Sense id complete 

05 Interrupt pending 

06 Active 
07 Sense 
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vm vse INT (V3R1.2 and later) 


11 

Port type (pdata) 


00 

Interrupt 


01 

Control 


02 

Inbound 


03 

Outbound 

12-13 

Zero 


14 

i/o stimulus for fsm manager 


06 

Normal completion 


07 

Attention 


08 

Attention and unit exception 


09 

Unit check 


0A 

Error 

15 

Channel-command code for the last 


04 

Sense (3088 compatibility) 


08 

TIC 


Cl 

Data buffer write 


C2 

Data buffer read 


C4 

Sense control unit state 


C5 

Control block write 


C6 

Control block read 


C7 

Data synchronization 


C9 

Data parameters write 


CB 

Set ceti mode on 


CD 

Interrupt parameters write 


E4 

Sense id 

16 

First byte of sense data 


80 

Command reject 


02 

Control block reject 

17 

Zero 


18 — IF 

Channel status word. 
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vse Interrupt (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vse INT 

CIO 

Channel Interrupt (Part 1) 

ISTRACCI 

ISTTSCLC 

VSE 


This trace record is written when a channel program interrupt occurs. 

Every int entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and int entries. The sio entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the ncb fields. See the diagnostic 
manuals for your operating system for a description of the 10 s fields. 



Byte (hex) 

Contents 

CO 

o 

1 

o 

o 

Record id: 

C'lNTB’ for BSCTYPE 

C'lNTH’ for HALTYPE 

C'lNTl' for ICNCB 

C'lNTL* for LDNCB 

04 

Task id 

05 

For intb and inth, link finite state machine (lfsm) 

For inti and intl, link station state (ncblnkst) 

06 

eract or zero 

07-08 

Zero 

09-0B 

Channel device name in ebcdic (either a cua or device number) 

0C-0F 

ncb address 

10-13 

Flag bytes (ncbflags) 
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vse INT 


14 ERCODorzero 

15 i/o completion code: ioscoo 

16-17 ncb sense data in ncbsense if this was a sense channel program; oth¬ 
erwise, zero 

18 -1F Channel status word from ncb. 
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vse Interrupt (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vse INT2 

CIO 

Channel Interrupt (Part 2) 

ISTRACCI 

VSE 


This trace record is a continuation of the int entry. 


INT2 


DEVICE-DEPENDENT 

INFORMATION 


Byte (hex) 

00-03 
04-07 
08-13 
14— IF 


Contents 

Record id: C‘int2’ 

Zero 

Device-dependent information shown below 
Zero 


For sdlc links (ncbtype = 09): 

08 Return code 

09 Buffer offset (sploffst) 

0A sdlc station address (spladdr) 

0B Control flag (splctlfg) 

0C Current sdlc number of last l-frame sent (splnscur) 

0D Last acknowledged l-frame (splnsack) 

0E Next l-frame to be received (splnracc) 

OF Command-in field (scxcmdin) 

10 Count of frames sent and acknowledged (scxcfrs) 

11 SCXCRBUF 

12- 13 Exception flags and exception code (scxexfcd) 

For bsc links (ncbtype=0A): 

08 First selection character (bscseli) 

09 First device address (bscdevi) 

0A Index of bpl entry for which input data was received (bscpesv) 

0B Device address from which input data was received (bscdevsv) 

0C Index for last station for which there was output data (bscisod) 

0D First response byte (bscrspai) 

0E Second response byte (bscrspa2) 

OF Last block type received (bsclbr) 

10 Current acknowledgment (bscaltak) 

11 Error retry count (bscrcnt) 

12 Connection manager flags (bsccmio) 

13 bsc flags (bscflags) 
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vm vse INT (V3R1.2 and later) 


vm vse Interrupt (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE INT 
CIO 

Start i/o 

istractr (snap trace recording routine) 

ISTAPCES 

VM VSE (V3R1.2 and later) 


This trace record provides information about interruptions at the telecommuni¬ 
cations subsystem or communication adapter interface. An entry is built for each 
i/o interrupt for an x .25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a control link channel program and a buffer pool channel program. 



Byte (hex) 

00-02 

03 


04 

05-07 
08-09 
0A-1B 
1C — IF 


Contents 

Record id: C'int’ 

Type: 

0C = Control link channel program 
0D = Buffer pool channel program 
Machine and task id 

Channel device name in ebcdic (either a cua or device number) 
Channel status word from ncb 
ncb sense data in ncbsense 
ncb address 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 8. Using the VTAM Internal Trace 417 




101 
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TPIO Request (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


101 

API 

tpio Request, Part 1 

ISTRACAP 

ISTAPCRS or ISTOCCSM 
MVS. VM, VSE 


This trace record shows api requests. It also provides the rpl information supplied 
by a vtam application program when it issues an RPL-based macroinstruction (such 
as send or opndst). The api routine istaicir issues the tpio svc. istapcti gets control 
from the svc, does validity checking, and queues the rpl to the pst request pab. 
After the pst request pab is dispatched, istapcrs gets control and writes the entry, 
or calls istoccsm to write the entry. 

See VTAM Data Areas for an explanation of the rpl fields. 


The process that is started with this event will be completed by a post (up), or an 
exit (re or ue). To correlate the two entries, match the rpl addresses. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

101 

R 

I 

E 

0 

0 

RPL 



NIB 



R 

S 

V 

V 

C 

RU 


0PTC2 

0PTC3 




E 

D 

X 


P 

ADDRESS 

ADDRESS 

H 

R 

T 

T 

H 

CNTL 












Q 


T 


T 





or CID 

3 

T 

F 

F 

N 

CODE 












T 


D 


1 










Y 

L 

L 
















Y 


S 












P 

1 

2 














Byte (hex) 

Contents 

00-02 

Record id: C‘ioT 

03 

rpl request type (rplreq) 


X 1 15' 

SETLOGON 


CD 

X 

SIMLOGON 


X 1 17 1 

OPNDST 


X'lA' 

INQUIRE 


X 1 IB 1 

INTRPRET 


X' IF 1 

CLSDST 


X'22 1 

SEND 


X 1 23 1 

RECEIVE 


X 1 24 1 

RESETSR 


X '25 1 

SESSIONC 


X ' 27' 

SENDCMD 


X' 28 ’ 

RCVCMD 


X 1 29 1 

REQSESS 


X'2A' 

OPNSEC 


X' 2C 1 

TERMSESS 

04 

ID 



• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 
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101 


05 

Exit definition (rplextds) 

06 

Zero 

07 

Option code byte 1 (rplopti) 

08-OB 

rpl address 

0C-0F 

nib address or cid 

10 

Third byte of rh (rplrh3) 

11 

Send/receive type (rplsrtyp) 

12 

VTAM flags (RPLVTFL1) 

13 

Post/respond flags (rplvtfl2) 

14 

ru chain position (rplchn) 

15-17 

ru control codes (rplcntrl) 

18 —IB 

VTAM options (RPLOPTC2) 

1C —IF 

VTAM options (RPLOPTC3) 
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MVS VSE TPIO Request (Part 2) 

Entry: mvs vse 102 

vit Option: api 

Event: tpio Request, Part 2 

vit Processing Module: istracap 

Applies to: mvs, vse 

This trace record is a continuation of the ioi entry. It shows additional information 
about the plu and slu in a session established or terminated by a simlogon, opndst, 
clsdst, reqsess. opnsec, or termsess macroinstruction. This information includes 
some of the parameters exchanged and the names of the plu and slu. 


0 0 0 

l 

0 

0 0 0 0 

00000000 

11111111 

11111111 

0 1 2 

3 

4 5 6 7 

89ABCDEF 

0 1 2 3 4 5 6 7 

89ABCDEF 

102 

0 

RETURN 

ADDRESS 

LOGON MODE NAME 
or 0 

PLU NAME 
(if available) 

SLU NAME 
(if available) 


Byte (hex) 

00-02 

03 

04-07 
08-OF 


10-17 
18— IF 


Contents 

Record id: C'i02‘ 

Zero 

Address of the issuer of the macro 

For simlogon. opndst, clsdst, or reqsess: Logon mode name 

(niblmode) or zero if the nib is not available 

For opnsec or termsess: Zero 

plu name or zero 

slu name or zero 
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MVS VSE 103 


mvs vse TPIO Request (Part 3) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


mvs vse 103 

API 

tpio Request, Part 3 

ISTRACAP 

MVS,VSE 


This trace record is a continuation of the 102 entry. It shows additional information 
in a session established or terminated by a simlogon, opndst, clsdst, reqsess, or 
opnsec macroinstruction. 



Byte (hex) 

00-02 

03 

04-07 


08 — IF 


Contents 

Record id: C'i03’ 

Zero 

For simlogon, clsdst, or reqsess: Address of user data (rplarea) 

For opndst or opnsec: Address of bind (nibndar) or zero if the nib is not 

available 

Zero 
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VM TPIO Request (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vm |02 

API 

tpio Request, Part 2 

ISTRACAP 

VM 


This trace record is a continuation of the ioi entry. It shows information about the 
plu and slu, such as some of the parameters exchanged and the names of the plu 
and slu. 


102 


RETURN 

ADDRESS 


LOGON MODE NAME 
or 0 


PLU NAME 
(if available) 


1 

1 

1 

1 

1 

1 

9 

A 

B 

C 

D 

LU 


SLU NAME 
(if available) 


Byte (hex) 

00-02 

03 

04-07 
08-OF 
10-17 
18— IF 


Contents 

Record id: C‘i02’ 

Zero 

Address of the issuer of the macro 

Logon mode name (niblmode) or zero if the nib is not available 
plu name or zero 
slu name or zero 
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vm |03 


VM TPIO Request (Part 3) 

Entry: 
vit Option: 

Event: 

vit Processing Module 
Applies to: 


This trace record is a continuation of the 102 entry. 



Byte (hex) Contents 

00-02 Record id: C'io3’ 

03 Zero 

04 — 07 Address of bind (nibndar) or zero if the nib is not available 
08-IF Zero 


vm 103 

API 

tpio Request, Part 3 

ISTRACAP 

VM 
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mvs |RB Dispatch 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


MVS IRBD 

PSS 

irb Dispatch 
ISTRACPS 
ISTAPCIE 
MVS 


This trace record provides information when an irb is dispatched. See the Debug¬ 
ging handbook for your operating system for a map of the tcb. 

Note: In addition to specifying the pss option, you must also set the racon bits to 
BT for this trace record to be created. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

IRBD 


I 


0 


PST 



PST 



PST 



IRB 



TCB 



F 

0 





D 




ADDRESS 

SYNC 


SYNC 


ADDRESS 

ADDRESS 

L 















TPPOSTD 

NORMAL 









G 















QUEUE 


QUEUE 










1 




Byte (hex) 

Contents 

00-03 

Record id: C'irbd’ 

04 

Address space id (or zero if address space id is greater than X 1 FF ') 

05-07 

Zero 

08-0B 

pst address 

0C-0F 

pst synchronous TPPOSTed queue anchor (pststpp) 

10-13 

pst synchronous normal queue anchor (pstsnrm) 

14-17 

irb address (tcbrbp) 

18— IB 

tcb address (psttcba) 

1C— ID 

pst flags (pstflgi) 

IE — IF 

Zero 
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mvs IRBX 


mvs IRB Exit 

Entry: mvs IRBX 

vit Option: pss 

Event: irb exit 

vit Processing Module: istracps 

Control is Returned to: istapcsd 

Applies to: mvs 


This trace record provides information about an irb exit. 

Note: In addition to specifying the pss option, you must also set the racon bits to 
B‘T for this trace record to be created. 


0 G 0 0 
0 12 3 

0 

4 

0 0 0 
5 6 7 

0 0 0 0 
8 9 A B 

0 0 0 0 
C D E F 

1111 
0 12 3 

1111 
4 5 6 7 

1111 
8 9 A B 

1111 
C D E F 

IRBX 

I 

0 

PST 

NEW TCB 

OLD TCB 

NEW 

OLD 

IRB 


D 


ADDRESS 

ADDRESS 

ADDRESS 

ASCB 

ASCB 

ADDRESS 







ADDRESS 

ADDRESS 



Byte (hex) Contents 

00-03 Record id: C'irbx’ 

04 Address space id (or zero if address space id is greater than X'FF') 

05-07 Zero 

08-0B pst address 

0C - OF New tcb address 

10-13 Old tcb address 

14-17 New ascb address 

18 - IB Old ascb address 

1C-IF irb address 
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VM VSE LAN Interface Control (V3R1.2 and Later) 

Entry: vm vse LIC 

VIT Option: CIO 

Event: Start i/o 

VIT Processing Module: istrac6T 

Control is Returned to: ISTTSC6R for lici 

ISTTSC6W for LICO 

ISTTSC6K Or ISTTSC6R for LICS 


Applies to: 


vm (V3R1.2 and later), vse(V3R2) 


One of these trace records is created when a command is sent to or received from 
the Token-Ring Subsystem. 

An lici record is written when a command is received from the subsystem. This 
entry always corresponds to a previous adpa or adpi entry. Use the tscb address to 
correlate these entries. 


An lico record is written when a command is ready to be sent to the subsystem. If 
the command is transferring a piu onto the ring, it corresponds to a previous piu 
entry. The tscb continuation address of the lico entry correlates to the tscb 
address of the piu entry. 


An Lies record is written when a special condition related to controlling the sub¬ 
system is detected. 


Q 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

LICI 

I 

CUA 

TSCB 


NCB 



C 

CMD 

T 

V 


F 


TSCB 


LICO 

D 




ADDRESS 

ADDRESS 

B 




F 

F 


L 


C0NT 

















I 




S 

S 


A 


ADDRESS 
















D 




M 

M 


G 

























S 

S 


S 






LICS 

I 

CUA 

TSCB 


NCB 



C 

CMD 

T 


REASON 







D 




ADDRESS 

ADDRESS 

B 




F 
























I 




S 
























D 




M 




























S 










Byte (hex) 

00-03 


04 

05-07 
08-0B 
0C-0F 
10 


Contents 

Record id: 

C'lici’ for an inbound record 
C‘lico’ for an outbound record 
C'lics’ for a special record. 

Machine and task id 

Channel device name in ebcdic (either a cua or device number) 

tscb address 

ncb address 

Control block id of ncb 

0E ncb for local station (vtam) 

0B ncb for remote station 
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vm vse LIC (V3R1.2 and later) 


11-13 Command 

See “vm vse Command Values Reported in Trace Entries” on page 297 
for more information about this field. 

14 LLC Port FSM (TFSMS) 

01 Logon pending 

02 Logon completion 

03 Logoff pending 

04 Enable pending 

05 Disable pending 

15 Channel Program fsm (tfsms) 



00 

Reset 


01 

Sense id 


02 

Interrupt port 


03 

Control port 


04 

Running 


05 

Sense 


06 

Orderly halt (hltc) 


07 

Termination 


08 

Shutdown 

For LICI or LICO: 


16 

llc Link fsm if cbid = X'0B' (vfsms) 


00 

Reset 


10 

actlink pending 


20 

Active 


30 

dactlink pending 

17 

llc Connection fsm if cbid = X'0B 1 (vfsms) 


00 

Reset 


10 

Connect in 


20 

Connect out 


30 

Connected 


40 

xid pending 

18 

llc Station fsm if cbid = X'0B' (vfsms) 


00 

Reset 


10 

xid zero pending 


20 

Set mode pending 


30 

Set mode wait 


40 

Active state 


50 

Request discontact 


60 

Disconnect pending 

19 — 1B 

Remote station flags if cbid = X'0B' 

1C — 1F 

tscb continuation address 


For LICS: 

16-IF Special reason text: 

C'clean up’ vtam has completed shutdown of the Token-Ring Sub¬ 
system. This entry is preceded by a ucs C’final term’ 
entry. 

C‘discard’ Subsystem input has been discarded. 

C’finalterm’ Channel programs to the subsystem have been 
stopped. 

C'halt rqst’ vtam is initiating shutdown of the subsystem. 
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Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


LKEX 

LOCK 

TPLOCK Exclusive 
ISTRACLK 
ISTAPC36 
MVS, VM t VSE 


This trace record identifies a request for exclusive control of a vtam lock and the 
current status of a lock. Exclusive locks can be held by only one vtam process. 
When a tpwait entry immediately follows this entry, it could be because a wait-for- 
lock condition exists. Look at the lockword in the trace output to see if the lock is 
already held. 


Locks obtained by lkex are eventually released by unlk or ulka. See Figure 9 on 
page 42 for a list of vtam locks. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

LKEX 


I 

0 

L 

L 

LOCK 


CRA 


RETURN 


LOCKWORD 



RPH 







D 


0 

E 

ADDRESS 

LKACT 

ADDRESS 









ADDRESS 







C 

V 































K 

E 
































L 


























Byte (hex) Contents 

00-03 Record id: C'lkex’ 

04 id 


05 

06-07 
08-0B 
0C-0F 
10-13 
14— IB 
1C — IF 


• For mvs, address space id 

(or zero if address space id is greater than X'FF’) 

• For vm, machine and task id 

• For vse, task id 
Zero 

Level of lock to be obtained 
Address of lock to be obtained 

cra lock account word (cralkact; see step 11 on page 41) 
Address of the issuer of the tplock macro 
Lockword for above level of lock 
rph address 
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LKSH 


TPLOCK Shared 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


LKSH 

LOCK 

tplock Shared 

ISTRACLK 
ISTAPC35 
MVS, VM, VSE 


This trace record identifies a request for a shared vtam lock and the current status 
of a lock. Shared locks can be held by more than one vtam process at a time. 
When a tpwait entry immediately follows this entry, it could be because a wait-for- 
lock condition exists. Look at the lockword in the trace output to see if the lock is 
already held. 


Locks obtained by lkex are eventually released by unlk or ulka. See Figure 9 on 
page 42 for a list of vtam locks. 



Byte (hex) 

00-03 

04 


05 

06-07 
08-0B 
0C-0F 
10-13 
14— 1B 
1C-1F 


Contents 

Record id: C‘lksh' 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 
Zero 

Level of lock to be obtained 
Address of lock to be obtained 

cra lock account word (cralkact; see step 11 on page 41) 
Address of the issuer of the tplock macro 
Lockword 
rph address 
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Lost Trace Record 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


LOST 

N/A 

Lost Trace Record 

ISTRACRR 

The location shown in register 14 

MVS. VM. VSE 


This trace record indicates that the internal trace table is incomplete. Information 
from events that were supposed to be traced was lost because there were not 
enough save areas available for the tracing routine to record the information. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

LOST 


I 


0 


REG 

14 






LOST TRACE RECORD 











D 





























Byte (hex) 

00-03 

04 


05-07 
08-0B 
0C-1F 


Contents 

Record id: C'lost’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 
Zero 

Register 14 (return address) 

C'LOST TRACE RECORD’ 
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MSG 


TPMSG or CPMSG (Parti) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


MSG 

MSG 

tpmsg Macro or cpmsg Macro (Part 1) 

ISTRACOT 
ISTCFCTM 
MVS, VM, VSE 


This trace record is written each time a message is issued by a vtam module. It 
can be used to find the originator of a message and to see whether it was solicited 
or unsolicited. 


msg trace entries are generated for all messages, even those that are suppressed 
by message-flooding prevention (described in VTAM Messages and Codes) or by 
the modify supp command (described in VTAM Operation), msg trace entries thus 
provide information that may be missing from the operator's console. 


tso/vtam messages (beginning with ikt) are not traced in the vit. See 
Chapter 4, “mvs Procedures for TSO/VTAM Problems” for tso/vtam information. 


MSG 


SAVE 

AREA 

ADDRESS 


MSG ID 

or 

1 USS 1 


RETURN 

ADDRESS 


MODULE 

ID 


DESTINATION 


Byte (hex) 

00-03 

04 


05-06 

07 


08-0B 
0C-0F 

10-13 

14-17 


Contents 

Record id: C‘msg’ 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Zero 

's’ or 'u\ If this field is 's', the message was solicited (in direct 
response to a vtam command). If this field is ‘u’, the message was 
unsolicited. 

Address of the issuer of the macro 

Message id or ‘uss’. If uss, the message id appears in the variable text 
field. 

Save area address 

Issuing module id (4th, 5th, 7th, and 8th characters of the issuing 
module name) 
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18 - IF Destination. If byte 07 is ‘s’, then this field contains one of the fol¬ 

lowing: 

• ‘systemxx’, where xx is the id of the system console. This is the 
name of the program operator application that requested the 
message. 

• 'nldm', when the message is destined for nldm. 

• ‘urc’, when the message is to be sent to the system console using 
routing codes, instead of to one console in particular. 

If byte 07 is ‘u’, this field is zero. 
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MSGS 


Message Sent Record (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


MSGS 

MSG 

Message Sent Record (Part 1) 
ISTRACOT 

ISTCFCWM or ISTLUCRC 
MVS, VM, VSE 


This trace record is written each time an attempt is made to send a message to its 
destination. It can be used to correlate the console sheet with the internal trace. 
The destination may indicate that the message was sent to a system console (via a 
wto macro) or to a program operator application, such as the NetView program 
(via a rcvcmd macro). 


0 0 0 0 

0 

0 0 0 

00000000 

1111 

0 12 3 

4 

5 6 7 

89ABCDEF 

0 12 3 

MSGS 

I 

0 

DESTINATION 

MESSAGE 


D 



HEADER 


FIRST 12 CHARACTERS 
OF MESSAGE TEXT 


Byte (hex) Contents 

00-03 Record id: C'msgs’ 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05-07 Zero 

08-OF Destination. If ‘systemxx’, the message was sent to system console 

‘xx’, via a wto macro. If an application name, the message was sent to 

a program operator application, via a rcvcmd macro. 

10-13 Message header (in hex). If destination is ‘systemxx’, this will be the 
wpl header. If destination is a program operator application, this will 
be a program operator header. 

14- IF First 12 characters of the message text. If the message text is longer 
than 12 characters, it will continue in MSG2. 
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TPMSG or CPMSG or Message Sent Record (Part 2) 

Entry: MSG2 

vit Option: msg 

Event: tpmsg Macro or cpmsg Macro, or Message Sent Record 

(Part 2) 

vit Processing Module: istracot 

Applies to: mvs, vm, vse 

This trace record contains variable data for the msg entry, or more message text 
for the msgs entry. This is a continuation of the msg or msgs trace record. 

00000000000000001111111111111111 

0123456789ABCDEF0123456789ABCDEF 

MSG2 VARIABLE DATA or MORE MESSAGE TEXT 

Byte (hex) Contents 

00-03 Record id: C‘msg2’ 

04- IF Variable data (if this is a continuation of a msg entry), or more 
message text (if this is a continuation of a msgs entry). 
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MU1 


LU 6.2 Message Unit (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 

Applies to: 


MU1 

APPC 

lu 6.2 message unit (Part 1) 

ISTRACAC 

Modules invoking the intrace macro causing the 

record to be produced 

MVS (V3R2), vm (V3R2), vse (V3R2) 


This trace record shows information about an lu 6.2 message unit. It is generated 
whenever a message unit is queued to another component. 


G 0 0 0 
0 12 3 

0 

4 

0 0 0 
5 6 7 

0 0 0 0 
8 9 A B 

0 0 0 0 
C D E F 

1111 
0 12 3 

r~ 

1 

4 

1 1 1 
5 6 7 

1111 
8 9 A B 

1111 

C D E F 

MUl 

I 

MU ID 

MU 

HS ID 

CORR 

R 

0 

AMU 

SENSE 


D 


ADDRESS 


ADDRESS 

E 


FLAGS 

DATA 







T 



or 0 







C 










D 





Byte (hex) Contents 

00-03 Record id: C'muT 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 

05-07 Message unit id 

X'010101' (end_conversation) 

X'010201' (PS_COPR_FMH5_RCVD) 

X'010302' (CONFIRMED) 

X'010303' (requesttosend) 

X'010304' (send_data_record) 

X'010305' (send_error) 

X'010306' (SEND PACING RSP) 

X 1 010501' (allocate rcb) 

X'010502' (deallocate_rcb) 

X'010503' (GET_SESSION) 

X ' 010504' (unbind protocol error) 

X'020101' (CNOSABORT) 

X'020201' (cnos cleanup) 

X’020501' (CNOS_COMPLETE) 

X'020502' (CHANGE SESSIONS) 

X'030102 ' (CONFIRMED) 

X'030103' (requesttosend) 

X'030104' (receive_data) 

X'030105' (receive_error) 

X'030106' (pacing rsp rcvd) 

X ' 030107' (rsp_to_request_to_send) 

X'030108' (initial_pacing_count) 
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X 1 030109' (DEALLOCATE_ABEND_REJECTED) 

X'030401' (ABORT_HS) 

X'030501' (ATTACH_HEAOER) 

X' 030502 ' (FREE_SESSION) 

X'030503' (BID) 

X'030504' (BID_RSP) 

X'030505' (Bis.RQ) 

X 1 030506' (bis_reply) 

X'030507' (RTR_RQ) 

X'030508' (RTR_RSP) 

X'040501' (session_activated) 

X'040502' (session_deactivated) 

X'040503' (ACTIVATE_SESSION_RSP) 

X' 040504 ' (CTERM_DEACTIVATE_SESSION) 

X'040505' (LNS_LRM_FREE_AMU) 

X'050101' (RCB_ALLOCATED) 

X'050103' (SESSION_ALLOCATED) 

X' 050104' (ATTACH_RECEIVED) 

X'050105' (CONVERSATION_FAILURE) 

X'050301' (HS_PS_CONNECTED) 

X' 050302* (YIELD_SESSION) 

X'050303* (BID_WITHOUT_ATTACH) 

X'050304' (BID_RSP) 

X'050305' (BlS_RQ) 

X'050306' (BIS_REPLY) 

X'050307' (RTR_RQ) 

X'050308' (RTR_RSP) 

X'050401' (ACTIVATE_SESSION) 

X'050402' (DEACTIVATE_SESSION) 

08-0B Message unit address 

0C - OF Half session id 

10-13 Address of correlator 

14 lu 6.2 message unit return code (amuretcd) 

15-17 Zero 

18 - 1B lu 6.2 message unit flags (amuflags) 

1C— IF lu 6.2 message unit sense data (amusense) or 0 
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MU2 


LU 6.2 Message Unit (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


MU2 

APPC 

lu 6.2 message unit (Part 2 ) 
ISTRACAC 

MVS (V3R2), VM (V3R2), vse (V3R2) 


This trace record is a continuation of the mui trace record. 


MU 2 


MU ID 


DATA 
ADDRESS 
or 0 


DATA 
LENGTH 
or 0 


RAB 

ADDRESS 
or 0 


SES 

CNT 

or 

0 


SES 

LIM 

or 

0 


CONV 

ID 

or 0 


VARI¬ 

ABLE 

OVERLAY 

FIELD 


Byte (hex) 

00-03 

04 

05-07 
08-0B 
0C-0F 
10-13 
14-15 

16-17 

18— IB 


1C — IF 


Contents 

Record id: C‘mu2’ 

Zero 

Message unit id (see “LU 6.2 Message Unit (Part 1)” on page 435) 
Data address or 0 
Data length or 0 

Resource allocation block address or 0 
For mu id X'020502': Session count 
For all other mu ids: Zero 
For mu id X'020502': Session limit 
For all other mu ids: Zero 

For mu ids associated with an active conversation (X 1 010201', 

X'030108', X' 050301'): Conversation id 
For all other mu ids: Zero 
Variable overlay field 


For mu ids X'010201', X'010501', and X'050101': Task id 


For mu id X'020201': copr control block address 


For mu id X’020502': 
1C-ID cnos delta 
IE — IF Zero 


For mu ids X'030106' and X'030108': Pacing count increment 

For mu ids X'030501', X'030503', X'030504', and X'030507': rph 
address for inbound half session 

For all other mu ids: Zero 
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LU 6.2 Message Unit (Part 3) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


MU3 

APPC 

lu 6.2 message unit (Part 3) 
ISTRACAC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the MU2 trace record. It is generated for only 
those message units which contain mu ids X' 010201 X' 010501 1 , X 1 020502', 

X*040501', and X'050401'. 


MU3 


o 

0 

0 

0 

0 

3 

4 

5 

6 

7 


0 

MU ID 


0 

0 

0 

0 

0 

0 

9 

A 

B 

C 

D 

E 


MODE NAME or 0 


1 

1 

1 

1 

1 

1 

1 

C\J 

3 

4 

5 

6 


LOCAL LU NAME 


1 

1 

1 

1 

1 

1 

9 

A 

B 

C 

D 

LU 


REMOTE LU NAME 


Byte (hex) 

Contents 

00-03 

Record id: C‘mu3’ 

04 

Zero 

05-07 

Message unit id (see “LU 6.2 Message Unit (Part 1)” on page 435) 

08-OF 

For mu ids X'010501', X*020502', X'040501and X'050401': Mode 

name 

For all other mu ids: Zero 

10-17 

Local logical unit name 

18— IF 

Remote logical unit name 
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NRSP 


Negative Response to a PIU Request (Part 1) 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


NRSP 

PIU 

Negative response to a piu request (Part 1) 

ISTRACOT 

ISTTSCGR 

VSE (V3R2),mvs,vm 


This trace record is written when vtam'STSC response generating routine, isttscgr, 
generates a negative response to a piu request. Since this entry is associated with 
an event failure, it is treated as an exception condition and is always traced, 
regardless of the vit options specified, if the vit is active. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

NRSP 


I 

C 

F 

0 

TSCB 







20 

BYTES 

OF PIU 











D 

B 

L 


ADDRESS 


























I 

A 































D 

G 
































S 



























Byte (hex) Contents 

00-03 Record id: C'nrsp’ 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 


05 

Control block id 

06 

Flag field (tscflagi) 

07 

Zero 

08-0B 

Address of tscb 

0C-1F 

First 20 characters of the piu 
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Negative Response to a PIU Request (Part 2) 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


NRS2 

PIU 

Negative response to a piu request (Part 2) 
ISTRACOT 

VSE (V3R2), MVS, VM 


This trace record is a continuation of the nrsp entry. It contains 24 more characters 
of the piu. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

0 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


NRS2 


24 MORE CHARACTERS OF THE PIU 


RETURN 

ADDRESS 


Byte (hex) 

00-03 
04 — IB 
1C — IF 


Contents 

Record id: C‘nrs 2 ’ 

24 more characters of the piu 
Return address of the issuer 
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OPER 


Operator Command (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 


Applies to: 


OPER 

MSG 

Operator Command 

ISTRACOT 

ISTLUCMD 

MVS ISTCFF3D, ISTINCF9 

VM ISTINVOO 

VSE (V3R2), MVS, VM 


This trace record is written each time a vtam command is issued at the operator 
console. This can help you match the console log to a surge of activity shown in 
the vit. This trace record is also useful when the console log is unavailable. Addi¬ 
tionally, it provides a record of poa commands that have been issued. These do 
not appear on the console log. 


The variable data in bytes 08 — IF is the command text, with minor modifications. If 
this data is longer than 24 characters, it will continue in OPE2. The command 
always appears in abbreviated form: 

d display command 

f modify command 

v vary command 

z halt command 

? Unknown command passed to vtam 


net and procname are excluded from the command text. Since the vtam internal 
trace is not active when vtam is started, the start command is not traced. 


0 

0 

0 

0 

0 

0 

0 

0 

O 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

OPER 


I 

F 

0 


FIRST 24 

CHARACTERS OF 

OPERATOR COMMAND 







D 

L 
































A 
































G 




























Byte (hex) 

00-03 

04 


05 

06-07 
08 — 1F 


Contents 

Record id: C‘oper’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 
Flag byte 

• If bit 0 = 1, a poa command was issued. 

• If bit 0 = 0, it was not a poa command. 

Zero 

First 24 characters of the operator command 
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Operator Command (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


OPE2 

MSG 

Operator Command (Part 2) 
ISTRACOT 

VSE (V3R2), MVS, VM 


This trace record is a continuation of the oper entry. It contains up to 28 more 
characters of the operator command. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


0PE2 


UP TO 28 MORE CHARACTERS OF THE OPERATOR COMMAND 


Byte (hex) Contents 

00-03 Record id: C‘OPE2’ 

04- 1F Up to 28 more characters of the operator command 
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VM VSE PIC (V3R1.2 and later) 


vm vse Packet Interface (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE PIC 

CIO 

Start i/o 

istractr (snap trace recording routine) 
ISTAPCES 

vm vse (V3R1.2 and later) 


This trace record provides information about internal control flows of the telecom¬ 
munications subsystem or communication adapter. 


0 

0 

0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


PIC 


INTERNAL TRACE DATA 


Byte (hex) Contents 

00-02 Record id: C'pic’ 

03-1F Internal trace data 
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PIU Record (Part 1) 


444 VTAM Diagnosis 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 


Applies to: 


PIU 

PIU 

piu Record (Part 1) 

ISTRACOT 

ISTTSCPR, ISTTSCLS, ISTTSCRI, ISTTSCSC, ISTTSCSR, ISTTSCWS, 

isttscpd, isttscle, isttscxs (or istincfi and intincsi for 

RUPE) 

MVS, VM, VSE 


This trace record provides information about external and internal FiD4Pius. 

For most Pius, only the first 48 bytes are traced (a 26-byte th, a 3-byte rh, and up to 
the first 19 bytes of ru). However, certain classes of Pius, such as session control 
rus and vtam rus, are traced in their entirety. 

If the control block is a rupe, the th is reconstructed by the internal trace using 
what information is available. For tscb entries, the piu is recorded as is. 


If the piu is a response with sense data, this entry will be generated whether the piu 
option is in effect or not. It is treated as an exception condition, and consequently, 
is traced, if the vit is active. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

PIU 


I 

C 

F 

0 

TSCB 







20 

BYTES 

OF PIU 











D 

B 

L 


or 




























I 

A 


RUPE 



























D 

G 


ADDRESS 



























S 



























Byte (hex) 

00-03 

04 


05 

06 

07 

08-0B 
0C-1F 


Contents 

Record id: C‘piu’ 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Control block id: X' 54' = rupe, X' 99 ‘ = tscb 
Flags (tscflagi, or zero if control block is a rupe) 
Zero 

tscb or rupe address (see byte 5) 

20 bytes of piu 
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PIU2 


PIU Record (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


PIU2 

PIU 

piu Record (Part 2) 

ISTRACOT 

MVS, VM, VSE 


This trace record contains 28 more bytes of an FID4 piu. It is a continuation of piu 
Record (Part 1). 


vit will generate as many as 32 piu2 records for Pius which are formatted and 
contain session control rus or rus to or from the sscp or pus. The number of 
records generated depends on the data count field in the th. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


PIU2 


28 MORE BYTES OF PIU 


Byte (hex) Contents 

00-03 Record id: C'piu2’ (an extension to a piu record) 

04 - IF Up to 28 more bytes of the FID4 piu (padded at right with zeros) 
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VM VSE Packet (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vm vsePKT 

CIO 

Start i/o 

istractr (snap trace recording routine) 
ISTAPCES 

vm vse(V3R1.2 and later) 


This trace entry provides information about the packets received at (pkti) or sent 
from (pkto) the x.25 port. 


A pkti trace record is written whenever the buffer control channel program com¬ 
pletes with packets received. 

A pkto trace record is written whenever a packet is transferred to the telecommu¬ 
nications subsystem or communication adapter by inserting it into the buffer 
control channel program. 

Note: If the packet is longer than 20 bytes (including packet header), up to 27 bytes 
of data are traced in an extension identified by the pktx trace record. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

Q 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

PKTI 


I 

CUA 

P 

I 

L 



FIRST 20 

BYTES 

OF THE PACKET 




PKTO 


D 




F 

N 

N 





























S 

D 

G 





























M 

X 

T 































H 






















Byte (hex) 

00-03 


04 

05-07 

08 

09 

0A-0B 

0 C-1F 


Contents 

Record id: 

C'pkti’ for inbound packet 
C'pkto' for outbound packet 
Machine and task id 

Channel device name in ebcdic (either a cua or device number) 
Packet finite state machine (pfsm) 

Index to slot that packet arrived on 
Packet length 

First 20 bytes of the packet 
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VM VSE PKTX (V3R1.2 and later) 


vm vse Packet Extension (V3R1.2 and Later) 

Entry: vm vse PKTX 

vit Option: cio 

Event: Start i/o 

vit Processing Module: istractr (snap trace recording routine) 

Control is Returned to: istapces 

Applies to: vm vse (V3R1.2 and later) 

This trace record is a continuation of the pkti or pkto trace record. 

00000000000000001111111111111111 

0123456789ABCDEF0123456789ABCDEF 


bb 


Byte (hex) Contents 

00-03 Record id: C'pktx’ 

04 Machine and task id 

05 - IF Up to 27 additional bytes of the packet. 
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TPPOST 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


POST 

PSS 

tppost Macro 

ISTRACPS 
ISTAPCTP 
MVS, VM, VSE 


This trace record identifies the rph that is being posted for restart after a tpwait 
macro. Usually the post entry is followed sometime later by a resm entry. 

However, when a tppost precedes the tpwait, the tpwait returns to the caller imme¬ 
diately without waiting. Then post is not followed by resm. 


POST 


0 

G 

0 

4 

5 

6 

I 

0 

P 

D 


A 

B 



0 

F 


0 

0 

0 

0 

7 

CO 

9 

A 


0 

0 

0 

C 

D 

E 


1 

1 

1 

0 

1 

2 


1 

1 

1 

1 

1 

l 

1 

1 

1 

1 

1 

4 

5 

6 

7 

CO 

9 

A 

B 

C 

D 

E 


PST 

ADDRESS 


PAB RETURN 
ADDRESS ADDRESS 


WORK 

ELEMENT 

ADDRESS 


DVT RPH 
ADDRESS ADDRESS 


Byte (hex) 

Contents 

00-03 

Record id: C'post’ 

04 

id 

• For mvs, address space id 

(or zero if address space id is greater 

• For vm, machine and task id 

• For vse, task id 

05 

Zero 

06-07 

pab offset 

08-0B 

pst address 

0C-0F 

pab address 

10-13 

Address of the issuer of the tppost macro 

14-17 

Work element address (from rphwea) 

18 — IB 

pab dvt address 

1C — IF 

Address of the rph being posted 
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MVS VM QREQ 


MVS VM Queued REQSTORE 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


mvs vmQREQ 
SMS 

Queued reqstore 

ISTRACSM 
ISTORMBQ 
MVS, VM 


This trace record identifies the reqstore requests that were waiting for a buffer, 
and which are now satisfied. 



Byte (hex) Contents 

00-03 Record id: C'QREQ’ 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 


05 

Control block id index value 

06-07 

Zero 

08-0B 

pst address 

0C-0F 

Address of buffer obtained 

10-13 

Zero 

14-15 

Number of buffers requested 

16 — 1B 

Zero 

1C — 1F 

rph address 
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TPQUE (Part 1, for V3R1, V3R1.1, and V3R1.2) 

Entry: QUE 

vit Option: pss 

Event: tpque Macro (Part 1) 

vit Processing Module: istracps 

Control is Returned to: istapctq 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 

This trace record shows a work element queued to a pab to allow another vtam 
routine to do further processing with the work element. This entry may be followed 
shortly by a disp entry, representing the pss dispatch of this pab. However, if the 
pab is already running, it might not be dispatched again. In this case, no disp entry 
follows the tpque. 



Contents 

Record id: C‘que’ 
id 

• For mvs, address space id 
(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 

Control block id of work element (Control block ids are shown in 
Appendix E, “Storage and Control Block ID Codes" on page 657.) 
pab offset 

Address of pst associated with pab 
pab address 

Address of work element to be queued 
pab chain field 

Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or pab dvt address (high order bit of X 1 18' = 0). 

The module name might be unavailable if the pab being scheduled is 
associated with a different address space than the current one. 

1C - IF rph address or zero 


Byte (hex) 

00-03 

04 


05 

06-07 
08-0B 
0C-0F 
10-13 
14-17 
18 — IB 
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QUE2 (V3R1, V3R1.1, and V3R1.2) 


TPQUE (Part 2, for V3R1, V3R1.1, and V3R1.2) 

Entry: QUE2 

vit Option: pss 

Event: tpque Macro (Part 2) 

vit Processing Module: istracps 

Applies to: MVS (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record is a continuation of the que trace entry. 




0 

0 


0 

0 

0 


0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 



2 

3 

| 

5 

6 

7 


9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

QUE2 


RETURN 

F 

A 



0 






PAB 

EXTENSION 

or 0 








ADDRESS 

L 

P 































A 

N 































G 

0 































S 

P 
























Byte (hex) 

00-03 

04-07 

08 

09 

0A-0F 
10 — IF 


Contents 

Record id: C‘que2’ 

Address of the issuer of the tpque macro 
pab scheduling flags (pabflags) 

tpque options (See field apnflgs in control block istapnop, VTAM Data 
Areas) 

Zero 

pab extension (pabxtnsn) if this is an extended pab. 
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TPQUE (V3R2) 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


QUE 

PSS 

tpque Macro 

ISTRACPS 

ISTAPCTQ 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record shows a work element queued to a pab to allow another vtam 
routine to do further processing with the work element. This entry may be followed 
shortly by a disp entry, representing the pss dispatch of this pab. However, if the 
pab is already running, it might not be dispatched again. In this case, no disp entry 
follows the tpque. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

QUE 

C 

I 

F 

N 

G 

PST 



PAB 



RETURN 

WORK 


MODULE 

RPH 






B 

D 

L 

0 

A 

ADDRESS 

ADDRESS 

ADDRESS 

ELEMENT 

NAME 


ADDRESS 




I 


A 

P 

T 













ADDRESS 

or DVT 

or 0 





D 


G 


E 

















ADDRESS 






Byte (hex) 

00-02 

03 

04 


05 

06 

07 


08-0B 
0C-0F 
10-13 
14-17 
18 — 1B 


Contents 

Record id: C‘que’ 

Control block id of work element (Control block ids are shown in 
Appendix E, "Storage and Control Block ID Codes" on page 657.) 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 
Flag field (pabflags) 

tpque options (See field apnflgs in control block istapnop in VTAM 
Data Areas.) 

Flag field 

• Bit 0 is the pab work element queue gate bit (pabweqg). 

• Bits 1, 2, and 3 are reserved by ibm. 

• Bit 4 is the pab change bit (pabchng). pabchng = o if the pab was not 
previously scheduled to run. pabchng = i if the pab was previously 
scheduled to run. 

• Bits 5, 6, and 7 are reserved by ibm. 
pst address 

pab address 

Address of the issuer of the macro 
Address of work element to be queued 

Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or pab dvt address (high order bit of X' 18' = 0). 


The module name might be unavailable if the pab being scheduled is 
associated with a different address space than the current one. 

1C - IF rph address or zero 
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QUEN 


TPQUE NONE 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


QUEN 

pss 

tpque none Macro 

ISTRACPS 
ISTAPCTQ 
MVS, VM, VSE 


This trace record shows a work element queued to any control block (not just a 
pab) to allow another vtam routine to further process the work element. 


QUEN 


PST 

ADDRESS 
or Q 


QUEUE 

ADDRESS 


RETURN 

ADDRESS 


WORK 

ELEMENT 

ADDRESS 


1 

1 

1 

1 

B 

C 

D 

E 


RPH 

ADDRESS 
or 0 


Byte (hex) 

00-03 

04 


05 

06-07 
08-0B 
0C-0F 
10-13 
14-17 
18— IB 
1C — 1F 


Contents 

Record id: C'quen’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Control block id of work element (Control block ids are shown in 
Appendix E, "Storage and Control Block ID Codes” on page 657.) 
Zero 

Address of pst or zero 

Address of the control block field to which the work element is queued 
Address of the issuer of the tpque none macro 
Address of work element to be queued 
Zero 

rph address or zero 
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RCE (V3R2) 
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Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


RCE 

NRM 

RCE Macro 

ISTRACNR 

ISTRACSC 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record contains information about an rceadd, rcechg, rcedel, or rcefind 
macroinstruction issued by a vtam module. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

RCE A 


I 

R 

T 

M 


KEY VALUE 


RETURN 

0UT1 or 

0UT2 or 

DATA 


RCEC 


D 

C 

Y 

0 









ADDRESS 

NEW 



NEW 



ADDRESS 

RCED 




P 

D 













TABLE 


TABLE 






RCEF 




E 

E 













NAME 


NAME 







Byte (hex) 

00-03 

04 


05 

06 

07 

08-OF 

10-13 

14-17 

18 — IB 

1C — IF 


Contents 

Record id: C‘rcea\ C‘rcec\ C'rced’, C'rcef’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 
Return code 
Type of rce entry 

Mode of rce entry (in hex) 

01 = Base entity mode 02 = Reference entity mode 

Key value (base entity name, base index, or reference index, 

depending on mode) 

Address of the issuer of the macro 

For rceadd, rcedel, and rcefind: Value in rcepouti 

For rcechg: First half of new table name 

For rceadd, rcedel, and rcefind: Value in rcepout2 

For rcechg: Second half of new table name 

Data address 
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RE 


RPL Exit 


Entry: RE 

vit Option: api 

Event: rpl Exit 

vit Processing Module: istracap 

Control is Returned to: istapcsx or istapcue 

Applies to: mvs, vm, vse 

This trace record contains rpl information passed from vtam to the application 
program. If the return code or feedback is non-zero, this entry will be generated 
whether the api option is in effect or not. It is usually treated as an exception con¬ 
dition, and consequently, is traced, if the vit is active. 


See VTAM Programming for a description of rpl return codes. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

i 

1 

, 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

RE 

R 

E 

I 

R 

F 

F 

RPL 



EXIT 


RPL 


RPL 


CID 


RPL 




E 

X 

D 

T 

D 

0 

AD0RESS 

ADDRESS 

AREA 


RLEN 


or 

0 


FDBK2 



Q 

T 


N 

B 

B 



























T 

D 


C 

2 

3 



























Y 

S 


D 




























Byte (hex) 

00-01 

02 


03 

04 


05 

06 

07 


Contents 

Record id: C're’ 

rpl request type (rplreq) 


X' 15' 

SETLOGON 

X' 16' 

SIMLOGON 

X 1 17 1 

OPNDST 

X* 1A' 

INQUIRE 

X' IB 1 

INTRPRET 

X 1 1F' 

CLSDST 

X '22 1 

SEND 

X' 23 1 

RECEIVE 

X 1 24 * 

RESETSR 

X'25' 

SESSIONC 

X 1 27' 

SENDCMD 

X'28‘ 

RCVCMD 

X‘29 1 

REQSESS 

X *2A' 

OPNSEC 

X'2C 1 

TERMSESS 


Exit definition (rplextds) 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

rplrtncd (See VTAM Programming) 

RPLFDB 2 (See VTAM Programming) 

rplfdb3 (See VTAM Programming , under inquire macro with 
optcd = appstat) 
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08-OB rpl address 

OC—OF Exit address 

10-13 rpl data area pointer (rplarea) 

14-17 Record length (rplrlen) 

18 -1B cid from nib or from rpl (rplarg) or zero 

1C—1F Second rpl feedback area - Sense code (rplfdbk 2 ) 
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RELS 


RELSTORE 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


RELS 

SMS 

relstore Macro 

ISTRACSM 
ISTORMBD 
MVS, VM,VSE 


This trace record provides the status of each relstore request issued by vtam com¬ 
ponents to release fixed-length buffers to one of the predefined buffer pools. 

relstore is the complement of reqstore. Storage obtained by reqstore must be 
released by relstore. However, since more than one buffer may be obtained and 
released at a time, there may not be a rels for every reqs, and there may not be a 
reqs for each rels. Use the “next buffer address” in rels and the “number of 
buffers” in reqs as clues. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

RELS 


I 

C 

P 

I 

PST 



BUFFER 

RETURN 

NEXT 


REG 1 

CALLER 





D 

B 

0 

D 

ADDRESS 

ADDRESS 

ADDRESS 

BUFFER 





OF 








I 

0 














ADDRESS 





UTILITY 






D 

L 














or 0 






or 0 



Byte (hex) 

00-03 

04 


05 

06-07 

08-0B 
0 C-0F 
10-13 
14-17 

18 — IB 
1C — 1F 


Contents 

Record id: C'rels' 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

For mvs and vm, control block id index value 

For vse, zero 

For mvs and vm, zero 

For vse, buffer pool id 

pst address 

Address of buffer to be released 
Address of the issuer of the relstore macro 

Pointer to the next buffer to be released if more than one buffer to be 
RELSTOREd; otherwise, zero 
Register 1 (normally rph address) 

Caller of utility routine, or zero 


• For mvs, address of the utility's caller, if the relstore macro was 
issued from a utility routine. Otherwise, zero if the macro was 
issued directly by the caller without a utility routine. (See bytes 
10- 13 for the address of the issuer of the relstore macro.) 

• For vm and vse, zero. 
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REQSTORE 


458 VTAM Diagnosis 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


REQS 

SMS 

reqstore Macro 

ISTRACSM 

iSTORMBA 

MVS, VM,VSE 


This trace record provides the status of each reqstore request issued by vtam 
components to obtain fixed-length buffers from one of the predefined buffer pools. 
The storage obtained by reqstore is released by relstore. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the sms option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the vit is active. 


REQS 


PST 

ADDRESS 
or 0 


BUFFER 
ADDRESS 
or 0 


RETURN 

ADDRESS 


NUM 

BUF 

REQ 


REG 1 


RETURN 

CODE 


Byte (hex) 

Contents 

00-03 

Record id: C'reqs’ 

04 

id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 

For mvs and vm, control block id index value 

For vse, zero 

06-07 

For mvs and vm, zero 

For vse, buffer pool id 

08-0B 

Pointer to the pst, or zero 

0C-0F 

Address of buffer obtained, or zero if buffer not obtained 

10-13 

Address of the issuer of the reqstore macro 

14-15 

Number of buffers requested 

16-17 

Zero 

18— IB 

Register 1 (normally rph address) 

1C — 1F 

Return code 
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RESM 


Resume from TPWAIT 

Entry: RESM 

vit Option: pss 

Event: Resume from tpwait 

vit Processing Module: istracps 

Control is Returned to: istapcpd 

Applies to: mvs, vm, vse 

This trace record gives information about which vtam process is about to be redis¬ 
patched after a tpwait. A resm entry follows a post, although not every post has a 
resm. Usually the post entry is followed sometime later by a resm entry. However, 
when a tppost precedes the tpwait, the tpwait returns to the caller immediately 
without waiting. Then post is not followed by resm. Use the rph address to find the 
original disp entry, which may have occurred quite some time earlier. 


0 0 0 0 

0 

0 

0 0 

O 

o 

o 

o 

0 0 0 0 

1111 

1111 

1111 

1111 

0 12 3 

4 

5 

6 7 

8 1 9 1 A | B 

C D E F 

0 12 3 

4 5 6 7 

8 9 A B 

C D E F 

RESM 

I 

C 

P 

PST 

PAB 

WORK 

WORK 

DVT 

RPH 


D 

B 

A 

ADDRESS 

ADDRESS 

ELEMENT 

ELEMENT 

ADDRESS 

ADDRESS 



I 

B 



ADDRESS 

QUEUE 





D 

o 

F 








Byte (hex) 

Contents 

00-03 

Record id: C'resm’ 

04 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 

05 

Control block id of work element (Control block ids are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657 

06-07 

pab offset 

08-0B 

pst address 

0C-0F 

pab address 

10-13 

Work element address 

14-17 

pab work element queue 

18— IB 

pab dvt address 

1C — IF 

rph address 
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TPSCHED (Part 1, for V3R1, V3R1.1, and V3R1.2) 

Entry: SCHD 

vit Option: pss 

Event: tpsched Macro (Part 1) 

vit Processing Module: istracps 

Control is Returned to: istapcts 

Applies to: mvs(V 3R1.1 andV3R1.2), vm(V 3R1.1 andV3R1.2), vse 

(V3R1 and V3R1.2) 


This trace record shows the schedule of a pab to be dispatched and the last work 
element, if any, that was queued to the pab. This entry should be followed shortly 
by a disp entry, representing the pss dispatch of this pab. 


0 0 0 0 

0 

0 

0 0 

0 0 0 0 

0 0 0 0 

1111 

1111 

1111 

1111 

0 12 3 

4 

5 

6 7 

8 9 A B 

C D E F 

0 12 3 

4 5 6 7 

8 9 A B 

C D E F 

SCHD 

I 

C 

P 

1 

PST 

PAB 

WORK 

PAB 

MODULE 

RPH 


D 

B 

A 

ADDRESS 

ADDRESS 

ELEMENT 

CHAIN 

NAME 

ADDRESS 



I 

B 



QUEUE 

FIELD 

or DVT 




D 

0 





ADDRESS 



F 


Contents 

Record id: C'schd' 
id 

• For mvs, address space id 
(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 
For mvs and VSE, zero 

For vm, control block id. (Control block ids are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 
pab offset 

pst address associated with pab 
pab address 

pab work element queue 
pab chain field 

Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or pab dvt address (high order bit of X' 18' = 0). 

The module name might be unavailable if the pab being scheduled is 
associated with a different address space than the current one. 

1C- IF rph address or zero 


Byte (hex) 

00-03 

04 


05 


06-07 
08-0B 
0C-0F 
10-13 
14-17 
18— IB 
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SCH2 (V3R1, V3R1.1, and V3R1.2) 


TPSCHED (Part 2, for V3R1, V3R1.1, and V3R1.2) 

Entry: SCH2 

vit Option: pss 

Event: tpsched Macro (Part 2) 

vit Processing Module: istracps 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), 

(V3R1 and V3R1.2) 


VSE 


This trace record is a continuation of the schd entry. 


0 

0 

0 

0 

0 

0 

0 

7 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SCH2 


RETURN 

0 

A 



0 






PAB 

EXTENSION 

or 0 








ADDRESS 


P 
































N 
































0 
































P 

; 

i_ 























Byte (hex) 

00-03 

04-07 

08 

09 

0A-0F 
10 — IF 


Contents 

Record id: C'sch2’ 

Address of the issuer of the tpque macro 
Zero 

tpsched options (See field apnflgs in control block istapnop in VTAM 
Data Areas) 

Zero 

pab extension (pabxtnsn) if this is an extended pab. 
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TPSCHED (V3R2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


SCHD 

PSS 

tpsched Macro 

ISTRACPS 

ISTAPCTS 

mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record shows the schedule of a pab to be dispatched and the last work 
element, if any, that was queued to the pab. This entry should be followed shortly 
by a disp entry, representing the pss dispatch of this pab. 



Byte (hex) Contents 

00-03 Record id: C'schd' 

04 id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF') 

• For vm, machine and task id 

• For vse, task id 

05 Flag field (pabflags) 

06 tpsched options (See field apnflgs in control block istapnop in VTAM 

Data Areas.) 

07 Flag field 

• Bit 0 is the pab work element queue gate bit (pabweqg). 

• Bits 1, 2, and 3 are reserved by ibm. 

• Bit 4 is the pab change bit (pabchng). pabchng = o if the pab was not 
previously scheduled to run. pabchng = i if the pab was previously 
scheduled to run. 

• Bits 5, 6, and 7 are reserved by ibm. 

08 - 0B pst address associated with pab 

0C-0F pab address 

10-13 Address of the issuer of the tpsched macro 

14-17 pab work element queue 

18 - IB Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or pab dvt address (high order bit of X 1 18' = 0). 


The module name might be unavailable if the pab being scheduled is 
associated with a different address space than the current one. 

1C-IF rph address 
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MVS SIO 


mvs Start I/O (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


MVS SIO 

CIO 

START I/O 
ISTRACCI 

ISTTSCIO Or ISTTSCLC 
MVS 


• The sioi trace record is written when a start i/o svc is issued for a channel- 
attached communication controller or SNA cluster controller. 

• The siol trace record is written when a start i/o svc is issued for a channel- 
attached non-SNA device. 

• The siox trace record is written when a start i/o svc is issued for a channel-to- 
channel attachment. 


The sio trace record will eventually be followed by an int entry. Use the cua field 
to match the correct entries. See VTAM Data Areas for a description of the ncb 
fields. 


SIOI 

or 

SIOL 


M 

0 

D 

I 

D 


CUA 


NCB 

ADDRESS 


FLAG 

BYTES 


CAW 


SIOX 


M 

0 

D 

I 

D 


CUA 


NCB 

ADDRESS 


FLAG 

BYTES 


CAW 


1 

1 

1 

1 

1 

1 

9 

A 

B 

C 

D 

LU 


CCW or 
DEVICE¬ 
DEPENDENT 
INFORMATION 


CCW or OUTPUT 
CONTROL AREA 
(STATUS 
INFORMATION) 


Byte (hex) 

00-03 


04 

05 

06-07 

08 

09-0B 
0C-0F 
10-13 
14-17 


Contents 

Record id: 

C'sioi’ for icncb 
C’siol’ for ldncb 
C’siox’ for XCNCB 

Address space id (or zero if address space id is greater than X 1 FF 1 ) 
For sioi and siol, link station state (ncblnkst) 

For siox, station state (xcnssfsm) 

Module id (last two characters of tsc module name) 

For sioi and siol, Write Start command 
For siox, zero. 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Virtual channel address word (ncbcaw) 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 8. Using the VTAM Internal Trace 463 




MVS SIO 


“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


18-IF If link is active: 

• For sioi and siol, device-dependent information: 

Byte (hex) Contents 

18- IB Virtual buffer address of the first Write ccw or zero 
1C Read Start command code or zero 

ID-IF Zero 

• For stox, output control area (status information). 

If link is not active, first channel command word (ccw). 
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MVS SI02 


mvs Start I/O (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


mvs SI02 

CIO 

START I/O 
ISTRACCI 

MVS 


This trace record is a continuation of the sio entry. 


0 

0 

0 

0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


SI02 


VIRTUAL 

BUFFER 

ADDRESS 


Byte (hex) 

00-03 
04-07 
08 — IF 


Contents 

Record id: C‘si 02 ‘ 

Virtual buffer address of the first Read ccw, or zero. 
Zero, or station state (xcnssfsm) for siox. 
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vm Start I/O (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM SIO 

CIO 

START I/O 
ISTRACCI 

ISTTSCIO Or ISTTSCLC 
VM 


This trace record is written when a start i/o svc is issued for a channel-attached 
communication controller or sna cluster controller. It will eventually be followed by 
an int entry. Use the cua field to match the correct entries. See VTAM Data Areas 
for a description of the ncb fields. 



Byte (hex) 

00-03 


04 

05 


06-07 

08 

09-0B 
0C-0F 
10-13 
14-17 


Contents 

Record id: 

C'siob’ for BSCLB 
C'SIOH’ for HALCB 
C'SIOI’ for icncb 
C'SIOL* for LDNCB 
C'SIOX’ for XCNCB 
Machine and task id 

For siob or sioh, link finite state machine (lfsm) 

Forsioi or siol, link station state (ncblnkst) 

Forsiox, station state (xcnssfsm) 

Module id (last two characters of tsc module name) 

Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Virtual channel address word (ncbcaw) 
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VM SIO 


18-IF For siob.sioh,sioi.siol: Zero 
For siox: 

• If link is active, output control area (status information) 

• If link is not active, first channel command word (ccw) 
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vm vse Start I/O (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


vm vseSIO 

CIO 

Start i/o 
ISTRAC6T 
ISTTSC6F 

vm(V 3R1.2 and later), vse(V3R2) 


This trace record is created when a Start i/o svc is issued for the Token-Ring Sub¬ 
system. Channel programs started for the subsystem do not always complete. If 
the channel program completes, it is eventually followed by an int entry. Use the 
cua field to match the correct entries. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SI0P 


I 

C 

M 

0 

CUA 

NCB 



P 

0 


CAW 


C 




0 








D 

P 

0 





ADDRESS 

D 







0 













F 

D 









A 







D 













S 

I 









T 







E 













M 

D 









A 
















Byte (hex) 

00-03 

04 

05 


06-07 

08 

09-0B 
0C-0F 
10 


11 


Contents 

Record id: C'siop’ 

Machine and task id 
Channel program fsm 
00 Reset 
01 Sense id 
02 Interrupt port 
03 Control port 
04 Running 
05 Sense 

06 Orderly halt (hltc) 

07 Termination 
08 Shutdown 

Module id (last 2 characters of tsc module name) 

Zero 

Channel device name in ebcdic (either a cua or device number) 
ncb address 
Port state (pdata) 

00 Reset 
01 Halt 

02 Halt complete 
03 Sense id 
04 Sense id complete 

05 Interrupt pending 

06 Active 
07 Sense 
Port type (pdata) 

00 Interrupt 
01 Control 
02 Inbound 
03 Outbound 
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vm vseSIO (V3R1.2 and later) 


12-13 Zero 

14—17 Channel address word 
18 Channel-command code for the first ccw 

C4 Sense control unit state 

CB Set ceti mode on 
E4 Sense id 
19—IF Zero 
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vm Start I/O (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vm SI02 

CIO 

START I/O 
ISTRACCI 
VM 


This trace record is a continuation of the sio entry. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

o 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SI02 


E 

T 

E 

R 

DEVICE- 

-DEPENDENT 

INFORMATION 





0 








R 

E 

R 

C 







or 

0 




















A 

C 

C 

0 





























C 

T 

0 

D 





























T 


D 

E 


























Byte (hex) 


00 — 03 

04 

05 

06 

07 

08-17 
18 — IF 


Contents 

Record id: C‘sio2’ 

ERACT 

Temporary error counter (tect) 

ERCOD 

Return code 

Device-dependent information shown below, or zero 
Zero 


For sdlc links (ncbtype=09): 

08 Index to current put 

09 Station flags 

0A Station finite state machine 

0B Connection finite state machine 

OC-17 Release-dependent information: 

For VTAM V3R1.1: 

0C Connection manager flags 

OD-17 First 11 bytes of ccw command code 

For vtam V3R1.2 and later: 

0C-0D Connection manager flags 

0E - 17 First 10 bytes of ccw command code 

For bsc links (ncbtype = 0A): 

08 Current channel program finite state machine (bscccfsm) 

09 Original channel program finite state machine (bscocfsm) 

0A Previous channel program finite state machine (bscpcfsm) 

0B Original failing channel program finite state machine (bscfcfsm) 

0C First selection character (bscseli) 

0D First device address (bscdevi) 

0E Index of bpl entry for which input data was received (bscpesv) 

OF Device address from which input data was received (bscdevsv) 

10 Index for last station for which there was output data (bscisod) 

11 First response byte (bscrspai) 
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12 Second response byte (bscrspa 2 ) 

13 Last block type received (bsclbr) 

14 Current acknowledgment (bscaltak) 

15 Error retry count (bscrcnt) 

16 Connection manager flags (bsccmio) 

17 bsc flags (bscflags) 
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vse Start I/O (Part 1) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VSE SIO 

CIO 

START I/O 
ISTRACCI 

ISTTSCIO or ISTTSCLC 
VSE 


This trace record is written when a start i/o svc is issued for a channel-attached 
communication controller or sna cluster controller. It will eventually be followed by 
an int entry. Use the cua field to match the correct entries. See VTAM Data Areas 
for a description of the nob fields. 


SIOB 

or 

SIOH 


M 

0 

D 

I 

D 


CUA 


NCB 

ADDRESS 


FLAG 

BYTES 


CAW 


SIOI 

or 

SIOL 


M 

0 

D 

I 

D 


CUA 


NCB 

ADDRESS 


FLAG 

BYTES 


CAW 


Byte (hex) 

00-03 


04 

05 

06-07 

08 

09-0B 
0C-0F 
10-13 
14-17 
18 — IF 


Contents 

Record id: 

C'siob’ for BSCLB 
C'SIOH’ for HALCB 
C'sioi’ for icncb 
C'SIOL’ for LDNCB 
Task id 

Link finite state machine (lfsm), or link station state (ncblnkst) 
Module id (last two characters of tsc module name) 

Zero 

Channel device name in ebcdic (either a cua or device number) 

ncb address 

Flag bytes (ncbflags) 

Virtual channel address word (ncbcaw) 

Zero 
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vseSI02 


vse Start I/O (Part 2) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Applies to: 


vseSI02 

CIO 

START I/O 
ISTRACCI 

VSE 


This trace record is a continuation of the sio entry. 


0 

0 

0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SI02 


E 

T 

E 

R 

DEVICE- 

-DEPENDENT 

INFORMATION 





0 








R 

E 

R 

C 







or 

0 




















A 

C 

C 

0 





























C 

T 

0 

D 





























T 


D 

E 


























Byte (hex) 


00-03 

04 

05 

06 

07 

08-17 
18— IF 


Contents 

Record id: C‘si 02 ’ 

ERACT 

Temporary error counter (tect) 

ERCOD 

Return code 

Device-dependent information shown below, or zero 
Zero 


For sdlc links (ncbtype = 09): 

08 Index to current put 

09 Station flags 

0A Station finite state machine 

0B Connection finite state machine 

OC-17 Release-dependent information: 

For vtam V3Ri: 

0C Connection manager flags 

OD-17 First 11 bytes of ccw command code 

For vtam V3R1.2 and later: 

0C-0D Connection manager flags 

0E —17 First 10 bytes of ccw command code 

For bsc links (ncbtype = 0A): 

08 Current channel program finite state machine (bscccfsm) 

09 Original channel program finite state machine (bscocfsm) 

0A Previous channel program finite state machine (bscpcfsm) 

0B Original failing channel program finite state machine (bscfcfsm) 

0C First selection character (bscseli) 

0D First device address (bscdevi) 

0E Index of bpl entry for which input data was received (bscpesv) 

OF Device address from which input data was received (bscdevsv) 

10 Index for last station for which there was output data (bscisod) 

11 First response byte (bscrspai) 
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12 Second response byte (bscrspa2) 

13 Last block type received (bsclbr) 

14 Current acknowledgment (bscaltak) 

15 Error retry count (bscrcnt) 

16 Connectionmanagerflags (bsccmio) 

17 bsc flags (BSCFLAGS) 
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vm vse Start I/O (V3R1.2 and Later) 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VM VSE SIO 

CIO 

Start i/o 

istractr (snap trace recording routine) 
ISTAPCES 

vm vse (V3R1.2 and later) 


This trace record provides information about Start i/o at the channel interface for 
an x.25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a control link channel program and a buffer pool channel program. An 
sio entry is built for the control channel program whenever it is started, and also 
when the buffer pool channel program is started. This channel program is an 
endless channel program and terminates only in case of error or when the adapter 
stops. 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SIO 

T 

I 

CUA 

P 

0 


DUMP OF WRITE 

CONTROL AND 

READ CONTROL 





Y 

D 




F 










DATA AREAS 












P 





S 



























E 





M 

























Byte (hex) 

00-02 

03 


04 

05-07 

08 

09 

0A-1F 


Contents 

Record id: C'sio' 

Type: 

0C = Control link channel* program 
0D = Buffer pool channel program 
Machine and task id 

Channel device name in ebcdic (either a cua or device number) 
Packet finite state machine (pfsm) 

Zero 

Dump of Write Control and Read Control data areas 
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ivs SRBD 


mvs SRB Dispatch 

Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


mvs SRBD 

PSS 

srb Dispatch 

ISTRACPS 

ISTAPCAD 

MVS 


This trace record provides information when pss is dispatched under an srb. 

Note: In addition to specifying the pss option, you must also set the racon bits to 
BT for this trace record to be created. 


SRBD 


PST 

ADDRESS 


PST 

ASYNC 

DISP 

QUEUE 

(ADSP) 


PST 

ASYNC 

FLAG 

FIELD 

(IAF) 


PST 

ASYNC 

N-DISP 

QUEUE 

(ANDSP) 


TCB 

ADDRESS 


F 

L 

G 

1 


Byte (hex) 

00-03 

04 

05-07 
08-0B 
0C-0F 
10-13 
14-17 
18- IB 
1C— ID 
IE — IF 


Contents 

Record id: C'srbd' 

Address space id (or zero if address space id is greater than X' FF') 
Zero 

pst address 

pst asynchronous dispatchable queue address (pstadsp) 
pst asynchronous flag field (pstiaf) 

pst asynchronous nondispatchable queue address (pstandsp) 
tcb address (psttcba) 
pst flags (pstflgi) 

Zero 
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MVS SRBX 


MVS SRB Exit 


Entry: mvs SRBX 

vit Option: pss 

Event: SRB Exit 

vit Processing Module: istracps 

Control is Returned to: istapcsx 

Applies to: mvs 

This trace record provides information when pss exits an srb. 


Note: In addition to specifying the pss option, you must also set the racon bits to 
BT for this trace record to be created. 


0 0 0 0 
0 12 3 

0 

4 

0 0 0 
5 6 7 

0 0 0 0 
8 9 A B 

0 0 0 0 
C D E F 

1111 
0 12 3 

1111 
4 5 6 7 

1111 
8 9 A B 

1111 
C D E F 

SRBX 

I 

D 

0 

PST 

ADDRESS 

PST 

ASYNC 

DISP 

QUEUE 

(ADSP) 

PST 

ASYNC 

FLAG 

FIELD 

(IAF) 

NEW 

ASCB 

ADDRESS 

OLD 

ASCB 

ADDRESS 

0 


Byte (hex) 

00-03 

04 

05-07 
08-0B 
0C-0F 
10-13 
14-17 
18— IB 
1C— IF 


Contents 

Record id: C'srbx’ 

Address space id (or zero if address space id is greater than X' FF') 
Zero 

pst address 

pst asynchronous dispatchable queue address (pstadsp) 
pst asynchronous flag field (pstiaf) 

New ascb address 
Old ascb address 
Zero 
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SRTCHG (V3R2 only), SRTADD, SRTDEL, SRTFIND 

Entry: SRT 

vit Option: NRM 

Event: srtadd, srtchg, srtdel, srtfind Macros 

vit Processing Module: istracnr 

Control is Returned to: istnrcsa for srtadd; istnrcsd for srtchg, srtdel, and 

SRTFIND 

Applies to: mvs, vm, vse 

This trace record contains information about a srtadd, srtchg, srtdel, or srtfind 
macroinstruction issued by a vtam module. 


Note: srtchg is new for vtam V3R2. 


G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

SRTA 


I 

R 

0 

T 

HASH 

NAME 



RETURN 

SRT 




NETWORK 

ID 


SRTC 


D 

C 


Y 

(NAME or 




ADDRESS 

ENTRY 










SRTD 





P 

NETWORK 








ADDRESS 









SRTF 





E 

ADDRESS) 





















Byte (hex) Contents 

00-03 Record id: C'srta’, C'srtc\ C'srtd’, or C'srtf' 

04 id 

• For mvs, address space id 


(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 


05 

Return code 


06 

Zero 


07 

Type of srt entry 


08-OF 

Network name or network address (padded 
to the hashing algorithm 

on left with zeros) passed 

10-13 

Address of the issuer of the srtadd, srtchg, 
struction 

srtdel, or srtfind macrom- 

14-17 

Address of srt entry for the resource 


18— IF 

Network id of the resource 
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UE (DFASY or RESP) 


USER Exit (DFASY or RESP) 

Entry: 
vit Option: 

Event: 

vit Processing Module 
Control is Returned to: 

Applies to: 

This trace record identifies the exit dispatched and data passed back to the user 
application program. 

If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the api option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the vit is active. 


For dfasy and resp exits (type codes = 07 and 08), the user exit trace record has 
the following format: 


0 

G 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

i 

1 

1 

1 

1 

1 

1 

0 

‘1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

UE 

C 

E 

I 

R 

F 

F 

RPL 



EXIT 


RPL 


RPL 


CID 


RPL 




0 

X 

D 

T 

D 

D 

ADDRESS 

ADDRESS 

AREA 


RLEN 


or 

0 


FDBK2 



D 

T 


N 

B 

B 



























E 

D 


C 

2 

3 




























S 


D 




























UE 

API 

User Exit 

ISTRACAP 

ISTAPCUE 


Byte (hex) 

00-01 

02 

03 

04 


05 

06 

07 

08-0B 
0C-0F 
10-13 
14-17 
18 — 1B 
1C — 1F 


Contents 

Record id: C'ue’ 

Exit type code (X' 7 1 = dfasy, X' 8 1 = resp) 

Exit definition (rplextds) 
id 

• For mvs, address space id 

(or zero if address space id is greater than X ' FF ' ) 

• For vm, machine and task id 

• For vse, task id 

rplrtncd (See VTAM Programming) 

RPLFDB2 (See VTAM Programming) 

RPLFDB3 (See VTAM Programming) 
rpl address 
Exit address 

rpl data area pointer (rplarea) or zero 

Record length (rplrlen) 

cid from nib or rpl (rplarg) or zero 

Second rpl feedback area — Sense code (rplfdbk 2 ) 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Chapter 8. Using the VTAM Internal Trace 479 




UE1 (Part 1, not DFASY or RESP) 


“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


USER Exit (Part 1, not DFASY or RESP) 

The user exit trace record (Not dfasy or resp, Part 1) has the following format: 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

i 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

6 

C 

D 

E 

F 


UE1 


I 

C 

0 


EXIT-TYPE 





PRIMARY 




SECONDARY 






0 

0 




DEPENDENT 





(APPL) 




LU 

NAME 








D 




INFORMATION 




LU NAME 




or 

0 










E 




























Byte (hex) 

00-03 

04 


05 

06-07 
08-OF 
10-17 
18 —IF 


Contents 

Record id: C‘uei‘ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

Exit type code (see Figure 69 on page 481) 

Zero 

Exit-type-dependent information (see Figure 69 on page 481) 
Primary (application program) logical unit name 
Secondary logical unit name, or zero if this is a tpend exit (see 
Figure 69 on page 481). 
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UE1 (Part 1, not DFASY or RESP) 


Exit 

Type 

Code 

Exit 

Type 

Byte 

(hex) 

Contents 

05 

SCIP (BIND) 

08-09 

RPL control flags (RPLCNTDC, RPLCNTSC) 



0A-0F 

Session parameters 

05 

SCIP (STSN) 

08-09 

RPL control flags (RPLCNTDC, RPLCNTSC) 



0A-0B 

RPLOBSQV 



OC-OD 

RPLIBSQV 



0E 

RPLOBSQ 



OF 

RPLIBSQ 

05 

SCIP (other) 

08-09 

RPL control flags (RPLCNTDC) 



0C-0F 

CID 

06 

LOGON 

08-0B 

Logon data length 



OC-OF 

CID 

09 

LOSTERM 

08-OB 

Reason code 



OC-OF 

CID 

0A 

RELREQ 

08 —OF 

Unused 

0D 

TPEND 

08 —OB 

Reason code 

0E 

NSEXIT 

08-OF 

NS RU bytes 0-7 


Figure 69. Exit-Type-Dependent Information for a UE1 Entry 
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USER Exit (Part 2, not DFASY or RESP) 

The user exit trace record (Not dfasy or resp, Part 2) has the following format: 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


UE2 


EXIT 

ADDRESS 


Byte (hex) 

Contents 

00-03 

Record id: C‘ue2' 

04-07 

Exit address 

08 — IF 

Zero 
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ULKA 


TPUNLOCK All 


Entry: ULKA 

vit Option: lock 

Event: tpunlock All Macro 

vit Processing Module: istraclk 

Control is Returned to: ISTAPC39 

Applies to: mvs, vm, vse 


This trace record contains information about a routine releasing all locks it cur¬ 
rently holds. 


0 G 0 Q 

0 

o 

o 

o 

O 

o 

o 

o 

o 

o 

o 

o 

1111 

11111111 

1111 

0 12 3 

4 

51617 

8|9|a|b 

c ID1E1F 

0 12 3 

4 5 6 7 8 9 A B 

C D E F 

ULKA 

I 

0 

PST 

CRA 

RETURN 

0 

RPH 


D 


ADDRESS 

LKACT 

ADDRESS 


ADDRESS 


Byte (hex) 

00-03 

04 


05-07 
08-0B 
0C-0F 
10-13 
14— IB 
1C-1F 


Contents 

Record id: C‘ulka’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X' FF') 

• For vm, machine and task id 

• For vse, task id 
Zero 

pst address 

cra lock account word (cralkact; see step 11 on page 41) 

Address of the issuer of the tpunlock macro 

Zero 

rph address 
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TPUNLOCK 


484 VTAM Diagnosis 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


UNLK 

LOCK 

TPUNLOCK Macro 

ISTRACLK 

ISTAPC33 

MVS.VM,VSE 


This trace record contains information for a routine releasing a lock. It is the com¬ 
plement of a lkex or lksh entry. 


UNLK 


L L 
0 E 
C V 
K E 
L 


LOCK 

ADDRESS 


CRA 

LKACT 


RETURN 

ADDRESS 


LOCKWORD 


RPH 

ADDRESS 


Byte (hex) 

Contents 

00-03 

Record id: C'unlk 1 

04 

id 

• For mvs, address space id 

(or zero if address space id is greater than X'FF') 

• For vm, machine and task id 

• For vse, task id 

05 

Zero 

06-07 

Level of lock to be released 

08 — 0B 

Address of lock to be released 

0C-0F 

cra lock account word (cralkact; see step 11 on page 41) 

10-13 

Address of the issuer of the tpunlock macro 

14 — IB 

Lockword 

1C — IF 

rph address 
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UP 


User Post 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


UP 

API 

User Post 
ISTRACAP 

ISTAICPT or ISTAPCSX 
MVS, VM,VSE 


This trace record provides the rpl information that vtam passes to the application 
program. The rpl information and the api tpio request record (Ain or ion) show 
vtam activity for a given api request. 

See VTAM Programming for a description of the rpl return codes. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the api option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the vit is active. 


— 

0 

0 

0 

0 

0 

7 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

7 1 

1 

i 

1 

1 

1 

1 

1 

1 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

UP 

R 

E 

I 

R 

F 

F 

RPL 



EXIT or 

RPL 


RPL 


CID 


RPL 




E 

X 

D 

T 

D 

D 

ADDRESS 

ECB 



AREA 


RLEN 


or 

0 


FDBK2 



Q 

T 


N 

B 

B 





ADDRESS 



















T 

D 


C 

2 

3 



























Y 

S 


D 




























Byte (hex) 

00-01 

02 


03 

04 


05 


Contents 

Record id: C'up' 

rpl request type (rplreq) 

X 1 15 ' 

SETLOGON 

X ' 16 1 

SIMLOGON 

X 1 17 ‘ 

OPNDST 

X‘ 1 A ' 

INQUIRE 

X ' 1B 1 

INTRPRET 

X' 1F 1 

CLSDST 

X *22' 

SEND 

X 1 23' 

RECEIVE 

X ' 24 ’ 

RESETSR 

X * 25 1 

SESSIONC 

X 1 27' 

SENDCMD 

X ' 28 ' 

RCVCMD 

X ' 29 ' 

REQSESS 

X 1 2A 1 

OPNSEC 

X‘2C ’ 

TERMSESS 

Exit definition (rplextds) 

ID 



• For mvs, address space id 

(or zero if address space id is greater than X'FF 1 ) 

• For vm, machine and task id 

• For vse, task id 

rplrtncd (See VTAM Programming) 
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06 rplfdb2 (See VTAM Programming) 

07 rplfdb3 (See VTAM Programming, under inquire macro with 

OPTCD = APPSTAT) 

08-OB rpl address 

0C-0F Exit address or ecb address 

10-13 rpl data area pointer (rplarEa) 

14-17 Record length (rplrlen) 

18-IB ciDfrom nib or from rpl (rplarg), or zero 
1C -1F Second rpl feedback area — Sense code (rplfdb«2) 
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VTAL 


VTALLOC 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VTAL 

SMS 

vtalloc Macro 

ISTRACSM 

ISTORMAF 


This trace record provides the status of each vtalloc request issued by vtam com¬ 
ponents. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the sms option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the vit is active. 


VTAL 


0 

0 

0 

0 

0 

0 

9 

A 

B 

C 

D 

E 


1 

1 

1 

0 

1 

2 


t—1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 


STORAGE 

ADDRESS 


SUBPOOL RETURN 
NUMBER ADDRESS 
or 

POOL ID 


LENGTH 

OF 

STORAGE 

REQUEST 


CALLER 

OF 

UTILITY 
or 0 


RETURN 

CODE 


Byte (hex) 

00-03 

04 


05-07 
08-0B 
0C-0F 


10-13 
14-17 
18— IB 
1C — IF 


Contents 

Record id: C'vtal’ 

ID 

• For mvs, address space id 

(or zero if address space id is greater than X' FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Zero 

Address of area allocated 

For mvs, subpool number of the area allocated 

For vm, buffer pool id 

For vse, buffer pool id 

Address of the issuer of the vtalloc macro 
Length of area allocated 
Address of issuer of utility routine or 0 
Return code 
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VTFREE 


468 VTAM Diagnosis 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


VTFR 

SMS 

VTFREE Macro 

ISTRACSM 

ISTORMAF 

MVS, VM, VSF 


This trace record provides the status of each vtfree request issued by vtam compo¬ 
nents. 


VTFR 


STORAGE 

ADDRESS 


SUBPOOL 

NUMBER 

or 

POOL ID 


RETURN 

ADDRESS 


LENGTH 

OF 

STORAGE 

FREED 


CALLER 

OF 

UTILITY 
or 0 


Byte (hex) 

Contents 

00-03 

Record id: C‘vtfr’ 

04 

id 

• For mvs, address space id 

(or zero if address space id is greater than 

• For vm, machine and task id 

• For vse, task id 

05-07 

Zero 

08-0B 

Address of area to be freed 

0C-0F 

For mvs, subpool number of the area allocated 
For vm, buffer pool id 

For vse, buffer pool id 

10-13 

Address of the issuer of the vtfree macro 

14-17 

Length of area to be freed 

18 — IB 

Address of issuer of utility routine or zero 

1C - IF 

Zero 
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WAIT 


TPWAIT 


Entry: 
vit Option: 

Event: 

vit Processing Module: 
Control is Returned to: 
Applies to: 


WAIT 

PSS 

tpwait Macro 

ISTRACPS 
ISTAPCTW 
MVS » VM * VSE 


This trace record identifies an rph that has been suspended to wait for some vtam 
resource. This entry might be used with the entry immediately preceding it in the 
table to determine whether the wait is for storage or for a lock. If the preceding 
entry is for a reqstore, a waiting-for-storage condition may exist. If the preceding 
entry is for a lock request, the wait could be caused by that request. However, 
vtam frequently uses a tpwait/tppost to synchronize intercomponent functions. 
Therefore, the tpwait entry does not necessarily identify an unusual condition. 


WAIT 


PST 

ADDRESS 


PAB 

ADDRESS 


RETURN 

ADDRESS 


WORK 

ELEMENT 

QUEUE 


MODULE 
NAME 
or DVT 
ADDRESS 


RPH 

ADDRESS 


Byte (hex) 

00-03 

04 


05-07 
08-0B 
0C-0F 
10-13 
14-17 
18 — IB 

18 — IB 
1C-1F 


Contents 

Record id: C'wait’ 
id 

• For mvs, address space id 

(or zero if address space id is greater than X 1 FF 1 ) 

• For vm, machine and task id 

• For vse, task id 
Zero 

pst address 
pab address 

Address of the issuer of the tpwait macro 
pab work element queue 

Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 
module to get control), or pab dvt address (high order bit of X' 18’ = 0) 
pab dvt address 
rph address 
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vm vse Disable Write Channel Program .534 
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vm vse Status Read Channel Program . 537 

vm vse Inquiry Read Channel Program .537 

vm vse Sense Channel Program 537 

vm vse Initial Write (Conversational) Channel Program .538 

vm vse Inquiry Write (Conversational) Channel Program .538 

vm vse Channel Program Finite State Machines for BSC Lines .539 

vm vse Channel Programs for an SDLC Communication Adapter Line .542 

vm vse Channel Commands ..542 

vm vse I/O Scheduling Overview of SDLC Lines .543 

vm vse I/O Scheduling for PU Services .544 

vm vse I/O Scheduling for the Link Level 2 Test .544 

vm vse Channel Programs 544 

vm vse Autopoll Channel Program .544 

vm vse Read PIU Channel Program 546 

vm vse Write PIU Channel Program 547 

vm vse Write Test Channel Program .‘548 

vm vse Sense SCB Channel Program .548 

vm vse Sense I/O Channel Program . .548 

vm vse Enable Line Channel Program .549 

vm vse Answer Channel Program . . ..550 
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Appendix A. Finding VTAM Buffer Pools 


mvs vm General Procedure for Finding VTAM Buffer Pools 

Use the following steps to find vtam buffer pools and to determine whether any 
have used all their buffers. Figure 70 on page 494 shows the control blocks 
involved in these steps. 

mvs Dumps processed with prdmp contain all the data necessary to use this proce¬ 
dure if the operand vtammap is coded in the prdmp control statements. (See “mvs 
vm Formatting and Printing Dump Output” on page 279 for more information about 
dumps processed using prdmp.) 

vm Dumps processed with prtdump contain all the data necessary to use this proce¬ 
dure if vtam control block formatting was requested. (See the VM/SP Interactive 
Problem Control System Guide for more information about dumps processed using 

PRTDUMP.) 

1. Find the atcvt. Its address is at low-storage location mvs X'408' orvMX'200'. 

mvs If this low-address location is not available in a dump, use the pointer in 
the cvt extension (cvtatcvt) to find the avt. Location X 1 00' in the avt points to 
the ATCVT. 

The atcvt is identified by release level at offset X'00 1 : 

• For vtam V3R1.1, the identifier is V3ii (X'E5F3F1F1'). 

• For vtam V3R1.2, the identifier is V312 (X' E5F3F1F2'). 

• For vtam V3R2, the identifier is VT32 (X 1 E5E3F3F2'). 

2. From the atcvt, find the address of the buffer pool directory (bpdty) in field 
ATCBPDA. 

3. bpdty + X ' 170 1 is the first buffer pool entry (bpent). There are 12 bpents, one 
for each buffer pool; each is X 1 10' bytes long and contains the name of a buffer 
pool at offset X'00', and the address of the buffer pool control block (bpcb) at 
offset X' 08 *. 

4. Find each bpcb. Each bpcb represents a buffer pool. 
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Figure 70. Buffer Pool Control Block Relationships 


494 VTAM Diagnosis 
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MVS VM Finding LPBUF 

Use the following steps to find the large pageable buffer pool (lpbuf) in mvs and vm. 
lpbuf is the buffer pool that contains the cra/rphs. Figure 70 on page 494 shows 
the control block relationships involved in these steps. 

1. Find the atcvt. Its address is at low-storage location mvs X'408' orvM X'200'. 

mvs If these locations are not available in a dump, use the pointer in the cvt 
extension (cvtatcvt) to find the avt. Location X'OO' in the avt points to the 

ATCVT. 

The atcvt is identified by release level at offset X'00': 

• For vtam V3Ri.i , the identifier is V3ii (X'E5F3F1F1'). 

• For VTAM V3R1.2, the identifier is V312 (X'E5F3F1F2'). 

• For vtam V3R2, the identifier is VT32 (X 1 E5E3F3F2'). 

2. From the atcvt, find the address of the buffer pool directory (bpdty) in field 

ATCBPDA. 

3. From the bpdty, find the buffer pool control block (bpcb) for the large pageable 
buffer pool (lpoo). The bpcb is pointed to by bpdty + X'1A8'. 

4. The beginning address of the static portion of the lpoo buffer pool is at bpcb + 
X'10'; the end of the static portion is pointed to by bpcb + X 1 14' . 

5. The first buffer begins at the address found in the bpcb + X 1 10'. To verify the 
correct buffer pool, offset X'08' in each buffer should have the address of the 
bpcb found in step 3. A buffer is allocated when bit bfpalloc is on. 

6. To find the second and third buffers, add X'550' to the address of the previous 
buffer. To find the fourth buffer, skip to the next page boundary (its address is 
a multiple of X' 1000'), or add X'560 1 to the address of the third buffer. Three 
buffers are on each 4K page of storage, followed by 16 unused bytes. 

When you reach the address in bpcb + X' 14', you have found the end of the 
lpoo buffer pool. 

7. To find lpoo buffer pool expansion areas, use the address of the pool extension 
block (pxb) at bpcb + X'90'. If the address is zero, there are no expansions — 
the buffer pool has not been expanded since vtam was started. In this case, 
skip steps 8 and 9. If there is an address, the buffer pool has been expanded 
dynamically and the expansions need to be examined; continue with the next 
step. 

8. Find the pxb, pointed to by bpcb + X'90 1 . The pxb offset X'OC' (pxbstadr) is 
the beginning of the pool expansion area. If pxbstadr=o, go to step 9. pxbs are 
not freed by vtam; only the area containing buffers is freed. The length of the 
expansion area (bpcbexln) is found at bpcb + X'D8. Add the length (bpcbexln) 
to the starting address (pxbstadr) for the end of the expansion area. 

9. Find the next pxb, pointed to by pxb + X'04' (pxbpxb). If pxbpxb^o, proceed as 
in step 8. If pxbpxb=o, there are no more expansion areas; the search is com¬ 
plete. 
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General Procedure for Finding VTAM Buffer Pools 

Use the following steps to find the buffer pools and determine whether any have 
used all of their available buffers. Figure 71 on page 497 shows the control blocks 
involved in these steps. 

1. Find the atcvt. Its address is at low-storage location X'10'. 

If this low-address location is not available in a dump, use the pointer at 
syscom + X'60' to find the avt. Location X'00' in the avt points to the atcvt. 

The atcvt is identified by release level at offset X 1 00 ’: 

• For vtam V3R1, the identifier is VT3i (X'E5E3F3F1'). 

• For vtam V3R1.2, the identifier is V312 (X'E5F3F1F2'). 

• For vtam V3R2, identifier is VT32 (X' E5E3F3F2 1 ). 

2. The atcvt is immediately preceded in storage by the buffer pool directory 
(bpdir) and the fixed-length pool pcbs, which can be identified by the pool ids in 
EBCDIC, (“vse Relative Locations of VTAM Buffer Pools” shows the relative 
locations of the buffer pools.) 

atcvt + X'3D4' also points to the bpdir. 
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VSE 


Finding LPBUF 

Use the following steps to find the large pageable buffer pool (lpbuf) in vse. lpbuf 
is the buffer pool that contains the cra/rphs. Figure 71 on page 497 shows the 
control block relationships involved in these steps, (“vse Relative Locations of 
VTAM Buffer Pools” has more information on the location of vtam buffer pools in 
VSE.) 

1. Find the atcvt. Its address is at low-storage location X* 10'. If this location is 
not available in a dump, use the pointer at syscom + X'60' to find the avt. 
Location X 1 00' in the avt points to the atcvt. 

The atcvt is identified by release level at offset X'00': 

• For vtam V3R1 , the identifier is VT31 (X 1 E5E3F3F1'). 

• For vtam V3R1.2, the identifier is V312 (X'E5F3F1F2'). 

• For vtam V3R2, the identifier is VT32 (X'E5E3F3F2'). 

2. From the atcvt, find the address of the buffer pool directory (bpdir) in field 
ATCBPDA (ATCVT + X'3D4‘). 

3. From the pointer at bpdir + X 1 14', find the buffer pool control block (pcb) for 
the large pageable buffer pool (lp). At offset X'08' in the pcb is the address of 
the start of the lp pool. 

4. To find the next buffer, add X'550' to the address of the buffer prefix (bfpfx) of 
the previous buffer. Continue with this process until the end of the lp buffer 
pool (at the address in pcb + X'OC'). 

Each buffer (including the prefix) is 1360 (X'550 1 ) bytes, and the buffers can 
cross page boundaries. The buffer size is also given in pcbbufsz (pcb + 

X' 22 1 ). 

The total number of buffers is given in pcbtotno (pcb + X' 24'). 

5. To find the lp buffer pool expansion areas, use the address of the pool exten¬ 
sion block (pxb) at pcb + X'58‘. If the address is zero, there are no expan¬ 
sions — the buffer pool has not been expanded since vtam was started. In this 
case, skip steps 6 and 7. If there is an address, the buffer pool has been 
expanded dynamically and the expansions need to be examined; continue with 
the next step. 

6. Find the pxb, pointed to by pcb 4- X'58 1 . The pxb offset X'OC (pxbstadr) is the 
beginning of the pool expansion area. If pxbstadr=o, go to step 7. pxbs are not 
freed by vtam; only the area containing buffers is freed. The length of the 
expansion area (pcbexln) is found at pcb + X'68‘. Add the length (pcbexln) to 
the starting address (pxbstadr) for the end of the expansion area. 

7. Find the next pxb, pointed to by pxb + X'04' (pxbpxb). If pxbpxb^o, proceed as 
in step 6 If pxbpxb=o, there are no more expansion areas; the search is com¬ 
plete. 
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Relative Locations of VTAM Buffer Pools 

To find a particular vtam buffer pool in a vse system, see the partition map in 
Figure 72 on page 500 and follow these steps: 

1. Find the ATCVTfrom location X'10\ if available, or from offset X'00‘ in the avt. 

2. Find the buffer pool directory (bpdir) from atcvt + X'3D4', or by subtracting 
X' 30' from the atcvt address. 

3. Find the pool control blocks (pcbs) from the pointers in bpdir, or by finding the 
ebcdic pool id preceding the bpdir in the storage dump (for fixed-length pools 
only). 

For all buffer pools, the beginning and ending addresses of the initial pool extent 
are contained in the pcb at offsets X 1 08 1 and X‘0C\ respectively. 

For fixed-length pools, the storage area may consist of one or more extents. The 
initial extent allocated when vtam is started contains the number of buffers indi¬ 
cated as a start parameter. Additional extents may be allocated if dynamic expan¬ 
sion is allowed for the pool. See Network Program Products Planning and VTAM 
Installation and Resource Definition for more information. 

To find the buffers in a fixed-length pool, start with the buffer prefix (bfpfx) pointed 
to by pcb + X 1 08'. The buffer prefix (bfpfx) is the 60-byte area, the third word of 
which points to the pcb. To find other buffers, add to or subtract from the address 
of the current prefix the length of the buffer (contained in the pcb + X 1 22') plus 60 
(X'3C') for the prefix. If the new location does not contain a bfpfx pointing to the 
same pcb, you have reached the end of the pool. 

Use the count of buffers at pcb + X 1 24 1 to determine whether there are also 
expansion extents. Information about them is found in the pxb, which is chained 
from pcb + X 1 58'. If that location is not equal to zero, and if the total buffer count 
at pcb + X 1 24' is greater than the number of buffers found in the initial extent, 
there are additional buffers pointed to by pxbs. Each pxb may point to a storage 
area. Examine location X'OC 1 in the pxb. If that location is not equal to zero, it is 
the beginning address of the extent. The number of buffers is contained at pxb + 

X' 16'. Examine the pxb chain pointer at X 1 04' to find the next pxb, if any. 
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Hex 20 


Hex 60 


Hex 0 


18 


Hex 10 


VTAM TCB VTAM Partition 



Figure 72. VSE Map of the VTAM Partition. 

* The identifier in ATCVT is VT31 (X'E5E3F3F1 1 ) for VTAM V3R1, V312 (X 1 E5F3F1F2') for VTAM V3R1.2, 
or VT32 (X 1 E5E3F3F2') for VTAM V3R2. 
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Appendix B. Channel Programs 

If you determine that the problem is in an i/o sequence, you will need to know the 
normal sequence of i/o ccws within the channel programs for the communication 
controller and channel-attached devices. With a dump, the vit trace with the cio 
option, or a ccwtrace (if available), you can compare the sequence that happened 
with the expected sequence. When there is a deviation, you can then look at status 
and sense bytes returned from the communication controller or the cluster con¬ 
troller for information that can help you determine the location of the error condi¬ 
tion. 
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Channel Programs for Channel-Attached Type 2 and 4 Physical 
Units 


The icncb represents type 2 and 4 physical units, and contains addresses and ccws 
needed for channel programs. Figure 73 shows the icncb and the location in 
storage of various ccws. 


ICNCB 



'- - ^ 


The number of read buffers 
equals MAXBFRU. 


Figure 73. Data Areas Used by Channel Programs for Physical Unit Types 2/4 
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Channel Commands 

The following channel commands are used by vtam to write data to and read data 
from channel-attached type 2 and 4 physical units. 


Command 

Code 

(hex) 

Command 

Description 

Contents of 
Address 

Field 

01 

Write 

Transfers data from storage in the 
host processor to the i/o device. 

Output area 

02 

Read 

Transfers data from the i/o device to 
storage in the host processor. 

Input area 

03 

No-op 

Causes the channel to respond with 
a channel end and device end. It is 
the last ccw in a read or write 
chain. 

Zero 

04 

Sense 

Transfers 1 or 2 bytes of sense data 
to storage in the host processor. 

Address of 
sense data area 

08 

TIC (Transfer 
in Channel) 

Causes the channel to fetch an 
instruction that is not the next 
sequential instruction within the 
channel program sequence. 

Address of next 
ccw to be exe¬ 
cuted 

09 

Write Break 

Transfers data from storage in the 
host processor to the i/o device and 
indicates that it is the last or only/ 
Write command in a chain of Write 

ccws. 

Output area 

31 

Write 

Start 0 

Begins a write sequence. Alternates 
with Write Start 1. 

Zero 

32 

Read 

Start 0 

Begins a read sequence. Alternates 
with Read Start 1. 

Zero 

51 

Write 

Start 1 

Begins a write sequence. Alternates 
with Write Start 0. 

Zero 

52 

Read 

Start 1 

Begins a read sequence. Alternates 
with Read Start 0. 

Zero 

61 

Write XID 

The host sends the Write xid 
command to signal the ncp that a 
channel contact sequence is begin¬ 
ning and to prepare to receive the 
host’s XID. 

Zero 

62 

Read XID 

The host sends the Read xid 
command to signal the ncp that the 
host expects to read the ncp’s xid. 

Zero 


Figure 74 (Part 1 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 
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Command 


Contents of 

Code 



Address 

(hex) 

Command 

Description 

Field 

A3 

Discontact 

Indicates that the channel is no 
longer contacted and the attach¬ 
ment to the transmission group 
should be broken. Releases the 

Pius on the channel hold and inter¬ 
mediate queues. 

Zero 

C3 

Contact 

Establishes contact between the 
host and the ncp. Tells the ncp to 
use xid information for operations 
with the host. 

Zero 

93 

Restart 

Causes the controller to reset its 
switches to indicate that the last 
Write Start and Read Start com¬ 
mands were Write Start 1 and Read 
Start 1 commands. 

Zero 

Note: 

Data transfer does not occur on Read Start or Write Start commands. 


Figure 74 (Part 2 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 


Format of TIC CCWs 

mvs/370 vm vse The Format 0 tic ccw is formatted as follows: 

Byte (hex) Contents 

00 X 1 08' (TIC identifier) 

01-03 Real address 
04-07 Reserved 

mvs/xa The Format 1 tic ccw is formatted as follows: 

Byte (hex) Contents 

00 X'08 1 (TIC identifier) 

01-03 Zero 
04-07 Real address 

A doubleword tic extension immediately follows both the Format 0 tic and the 
Format 1 tic. VTAM uses the last 4 bytes of the tic extension to contain the virtual 
address of the next buffer in the chain. 

The tic extension is formatted as follows: 

Byte (hex) Contents 

08-0B Reserved 
0C-0F Virtual address 

For Write buffers, the next to the last physical buffer is handled specially. The real 
address of the tic points to the last Write Break ccw (icnwbccw), but the virtual 
address points to the last Write buffer that contains data (see Figure 75 on 
page 505.) This last buffer is formatted with a Write Break ccw which is not used, 
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but is copied into icnwbccw. If only one buffer exists in the channel program, the 
Write Start tic is formatted so that the real address points to icnwbccw, but the 
virtual address points to the only Write buffer. 

Note that the last Write buffer looks unusual because the Write Break command is 
chained but the next ccw is zero. This Write Break is never physically executed by 
the channel, but the copied version of the ccw (in the icncb) is executed. 



CD - Chained Data bit on 
CC = Command Chaining bit on 

Figure 75. Write CCWs with Chained Data 
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Channel Program Sequences 

The following describes the ccws, in the order that they are executed, in a typical 
Write channel program. 

1. ICNWSCCW - Write Start: Each time a Write sequence (the Write Start and all 
associated Write buffers) has completed successfully, the Write Start ccw is 
alternated: The first Write Start operation code is X'31' (Write Start 0), the 
second Write Start code is X '51 1 (Write Start 1), the third Write Start code is 
X'31', and so on. There is no data transfer associated with this ccw; it is used 
to inform the controller that the previous Write has successfully completed. 

2. ICNWSTIC - Write Start TIC: This ccw is used to chain to the first Write ccw. 
When the Write channel program consists of a single Write buffer, the real 
address points to icnwbccw (the last Write Break). The virtual address of this 
ccw always points to the first Write buffer on a chain or is zero when no Write 
channel program is pending or active for the device. 

3. Write or Write Break CCWs Alternating with TICs: Figure 73 on page 502 
shows the write buffers required for writing three Pius, each of which is con¬ 
tained in a single buffer. Figure 75 on page 505 shows the Write buffers 
required for writing two Pius, when each spans three buffers. 

4. ICNWBCCW CCW(3) - Last Write Break: This is the last Write ccw in a channel 
program that is physically executed by the device. The data address points to 
the last Write buffer that contains data. If a read is requested, when this opera¬ 
tion completes the controller will signal a status modifier (in addition to 
channel end and device end). This causes icnnpccw to be skipped by the 
channel. 

5. ICNNPCCW - No-Op: If a Write completes and no Read is requested, this is the 
ending ccw in a channel program. If a Read was requested, this ccw is skipped 
by the channel. The command chain flag will be on in this ccw if a Read was 
previously requested but was not previously initiated, and Read buffers are 
available. 

6. ICNSMNOP - Status Modifier No-Op: This ccw receives control after the last 
Write Break, if a Read is signaled. This ccw normally command chains to the 
Read Start so that writing and reading both occur without an intervening inter¬ 
ruption. If no buffers are available, however, the channel program ends here 
and vtam recognizes that a Read is required. 

7. ICNRSCCW - Read Start: Each time a Read sequence (the Read Start and at 
least one Read) has completed successfully, the Read Start ccw is alternated. 

The first Read Start generation code is X'32' (Read Start 0), the second Read 
Start generation code is X'52‘ (Read Start 1), the third Read Start generation 
code is X'32', and so on. 

As with the Write Start ccw, there is no data transfer. The ccw alternation is 
used to inform the controller that the previous Read has successfully com¬ 
pleted. 

When a Write is not required but a Read has been requested by an attention 
status, this is the first ccw in the channel program. 
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8. ICNRSTIC - Read Start TIC: This ccw is used to chain to the first Read ccw. 

The virtual address of this ccw points to the first Read buffer on the chain, 
except: 

• When deblocking Pius, in which case the virtual address is changed by the 
channel end appendage. 

• When there are not enough read buffers available, in which case it is zero. 

9. Read CCWs Alternating with TICs: Figure 73 on page 502 shows the buffers 
required for reading three Pius. 

10. Read No-Op: This ccw should never be executed. If it is, it indicates that the 
controller and vtam do not agree on how many Read buffers are required. 

The normal ending status for a Read is channel end/device end/attention/unit 
exception. The unit exception indication is presented on the Read ccw that has 
completed data transfer, and terminates the command chaining. The attention 
is the same as a unit exception but it also indicates that a Read is requested. 

Unit exception may also be presented to the Read Start ccw. This is used by 
the controller to release input buffers. If the same Read Start (as opposed to 
the alternate Read Start) is given to the controller, the data buffers must be 
re-sent. 
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PUNS-Related Channel Programs 

During activation of an ncp in a channel-attached communication controller, the 
sscp sends a Contact ru to puns, puns responds by giving control to isttscp4 to 
schedule one of five channel programs. These channel programs follow (A -E). 




Code 




CCW 

(hex) 

Flags 

Notes 

A. 

Sense 

04 

SLI 

Determines if the device needs to be 
loaded. 

B. 

Write XID 

61 

SLI.CC 

This channel program follows A if the 


No-Op 

03 

SLI 

device does not need to be loaded. It is 
followed by either C or D. 

C. 

Write Break 

09 

SLI.CC 

This channel program follows B if there is 


Read XID 

62 

SLI.CC 

no command reject. 


Read 

02 

SLI.CC 



No-Op 

03 

SLI 


D. 

Restart/Reset 

93 

SLI.CC 

Executed only if the Write xid in B caused 


No-Op 

03 

SLI 

a command reject (implies the ncp is ncp 
R elease 2 or earlier). 

E. 

Contact 

C3 

SLI.CC 

Restart/Reset is executed only if a Con¬ 


Restart/Reset 

93 

SLI.CC 

tacted (error) response is sent to puns. 


No-Op 

03 

SLI 



One of the following channel programs is executed when the sscp sends a Discon- 
tact ru to PUNS. 


CCW 

Code 

(hex) 

Flags 

Notes 

F. Discontact 

A3 

SLI.CC 

This channel program is executed only if 

No-Op 

03 

SLI 

B did not cause a command reject. 

G. No-Op 

03 

SLI 

This channel program is executed if B 
caused a command reject. 


These ccws are contained in i/o buffers that are allocated from the iobuf buffer pool 
when doing puns i/o. 

The data area pointed to by the address portion of a Read xid or Write xid ccw is 
described in VTAM Data Areas (see istxid). 
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The following channel programs are written by adjacent physical unit network ser¬ 
vices (apuns) for pseudo-dial support of a type 2 physical unit. 


Channel 

Program Code 

Name _ CCW _(hex) Flags Notes 

A. Dial Out Sense 04 SLI.CC Executed when the sscp 

No-Op 03 SLI sends a Connect Out 

request to puns. Success 
means the physical con¬ 
nection is complete. 
Failure means the device 
is not operational. 


B. Dial Sense 

Enable No-Op 

Answer 


04 SLI.CC Executed when the sscp 

03 SLI sends an Activate 

Connect In. Success 
means that the physical 
connection exists. (The 
type 2 physical unit is 
dialed in.) Failure means 
that the physical con¬ 
nection does not exist. 
(The type 2 physical unit 
has not dialed in yet.) 


C. Dial 

ipl (Connect) 

05 

Contact 

Restart/Reset 

93 

(Connect) 

No-Op 

03 


SLI.CC Executed during acti- 
SLI.CC vation of a type 2 physical 
SLI unit when the sscp sends 
a Contact request to puns. 
The ipl ccw transfers 
initialization parameters 
to the device. The 
Restart/Reset ccw resets 
the Read/Write indicators 
so that vtam and the 
device are synchronized. 


D. Abandon IPL 

Connection (Disconnect) 

No-Op 


05 SLI.CC Executed when the sscp 

03 SLI sends an Abandon Con¬ 

nection ru to puns to dis¬ 
connect the type 2 
physical unit. 


These ccws are contained in pageable working storage allocated by apuns 

(ISTINCYO). 

Figure 76 on page 510 shows the data area pointed to by an ipl (Connect) ccw. 
Figure 77 on page 510 shows the data area pointed to by an ipl (Disconnect) ccw. 
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000A 

0001 

No. of 
Buffers 

Size of 
Buffers 

0004 

i j 

V _ J 


v- v - / 

--V- Y 

Length Code 

Header 


Figure 76. Data Area Pointed to by an IPL (Connect) CCW 


0004 


0002 


v -V-' V - 

Length Code 


Figure 77. Data Area Pointed to by an IPL (Disconnect) CCW 


Channel Programs for Channel-to-Channel Adapters 

Channel Programs for Channel-to-Channel Adapters for Pre-V3R2 

The following applies to vtam V3ri, V3R1.1, and V3R1.2 in which the "ctc 
enhancement” ptf has not been applied. If the “ctc enhancement” ptf has been 
applied to your vtam V3ri, v3Ri.i, or V3R1.2 system, or if you are using vtam V3R2, 
please see “Channel Programs for Channel-to-Channel Adapters for V3R2” on 
page 514 for the description of channel programs for channel-to-channel adapters. 

Each side of a channel-to-channel adapter (ctca) is represented by a cross-channel 
node control block (xcncb). In addition, each side has a physical unit service i/o 
(pio) control block and a station control block (see). The pio is used for exchange id 
(xid) channel programs (the physical unit services i/o that occurs before the link is 
active). The pio is mapped by istpio. The scb is a station work area where ccws 
for normal data transfer are built. It is not mapped, and is not described in VTAM 
Data Areas. 

Normal data transfer channel programs can be either a sequence of write ccws fol¬ 
lowed by read ccws (this is on the X-side) or a sequence of read ccws followed by 
write ccws (on the Y-side). vtam determines which side will be the X-side and 
which side will be the Y-side during the initial xid channel program (the 
X-side/Y-side usage does not depend on the hardware attachment). From that 
point on, the X-side of the adapter always builds a channel program with the write 
ccws first, followed by read ccws. TheY-side of the adapter always builds a corre¬ 
sponding channel program with read ccws first, followed by write ccws. 

Figure 78 on page 511 shows how vtam determines which side will be the X-side 
and which side will be the Y-side. In this example, the operator in subarea 4 is the 
first to activate the link. Because subarea 2 is not active, the xid exchange does 
not complete. Later, when the operator in subarea 2 activates the link, the xid 
exchange completes. 
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During the xid exchange, each host informs the other host of the size and number 
of read buffers that will be used in the read portion of its channel programs. Each 
host then tailors the write portion of its channel programs to exactly match the read 
portion of the other host’s channel programs. Figure 79 on page 512 and 
Figure 80 on page 513 show how a write channel program might have to be tai¬ 
lored to match a read channel program. 


Subarea 4 Subarea 2 

SSCP PUNS TSC CTCA TSC PUNS 



0 PUNS queues a RUPE to NCBPUPAB, causing TSC to get control. 

U TSC posts PUNS. 

0 Subarea 4 assumes X-side protocols because it is initiating the XID exchange. 
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11 The XID exchange “times out" because the link in subarea 2 has not been acti¬ 
vated. Subarea 4 then assumes Y-side protocols and waits for the other side to 
initiate its contact procedure. 

H Assume the operator activates the link in subarea 2. Subarea 2 assumes 
X-side protocols. 

1! The low subarea responds first to the XIDO exchange by sending an XID7. 
(Subarea 2 has a lower subarea number than subarea 4.) 

j|| Subarea 4 checks the XID7 from subarea 2 and responds with its XID7. It also 
sends a CONTACTED RU to the SSCP. 



Other Side’s 

Write Buffer Read Buffer 



Figure 79. Writing from Large Buffers into Small Buffers. In this example, the write buffers are larger than the read 
buffers. Since the second and third Write CCWs are writing into the same read buffer, the second Write 
CCW has the Chained Data (CD) bit set on, and the second and third CCWs cause a single write opera¬ 
tion. 
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Other Side's 

Write Buffer Read Buffer 



Figure 80. Writing from Small Buffers into Large Buffers. In this example, the read buffers are larger than the write 
buffers. Therefore, two consecutive write operations are required to filt one read buffer. The first Write 
CCW has the Chained Data (CD) bit set on, since the first and second Write CCWs are writing into the 
same read buffer. 
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Channel Programs for Channel-to-Channel Adapters for V3R2 

The following applies to vtam V3R2, and to vtam V3R1. vsri.i, and V3R1.2 with the “ctc 
enhancement” rtf applied. References to PRE-V3R2 are for vtam V3Ri, V3R1.1, and 
V3R1.2 in which the “ctc enhancement” ptf has not been applied. 

During xid processing, vtam indicates the support level of ctc communications. If 
the other host in the connection is back-level, the support used will be the vtam ctc 
support as described in “Channel Programs for Channel-to-Channel Adapters for 
Pre-V3R2” on page 510. 

vtam V3R2 reduces the number of ccws exchanged during xio processing. 

Prior to V3R2, there were maxbfru reads and writes, plus a constant seven environ¬ 
mental ccws. 

With V3R2, maxbfru defines a single read buffer. The opposing vtam write buffer is 
exactly the same size, pius are blocked for transfer, and are written by a single 
write, and read by a single read. 

With the new blocking protocol, there are just three ccws. V3R2 uses the write and 
read ccws, as well as a ccw which is either a wctl or scb. For each buffer write, 
only 3 ccws are exchanged in V3R2. Control information is included with the first 
buffer transferred in the same ccw as the pius in the block. This eliminates the use 
of write control, read control, validity check, and no_op ccws. 

Each side of a channel-to-channel adapter (ctca) is represented by a cross-channel 
node control block (xcncb/ycncb). In addition, each side has a physical unit service 
I/O (pio) control block. The pio is used for exchange id (xid) channel programs (the 
physical unit services i/o that occurs before the link is active). The pio is mapped 
by istpio. 

Normal data transfer for channel programs is a write ccw followed by a read ccw 
(this is on the X-side) or a read ccw followed by a write ccw (on the Y-side). vtam 
determines which side will be the X-side and which side will be the Y-side as 
described in “Channel Programs for Channel-to-Channel Adapters for Pre-V3R2" 
on page 510. 

During the xid exchange, each host informs the other host of the size in pages of 
the read buffer that will be used in the read portion of its channel programs. Each 
host then allocates a write buffer to exactly match the read buffer of the other host. 
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Channel Commands 

The following channel commands are used for channel programs between two 
hosts connected by a channel-to-channel adapter. 


Command 

Code 

(hex) 

Command 

Description 

01 

Write 

Transfers data from storage to this host 
processor to the ctca. For ctcas, this ccw is 
used to transfer status information from 
xcnoctl, xid information from piopotxt, validity 
checking information from xcnovtxt, and data 
from buffers. 



In vtam V3R2, status information, mapped by 
xcnoctl, is transferred in the first eight bytes 
of the write buffer, and only one write buffer is 
used. Figure 81 on page 516 illustrates the 
buffer usage in V3R2. 

02 

Read 

Transfers data from the ctca to this host 
processor. For ctcas, this ccw is used to read 
status information into xcnictl, xid information 
intoPioPiTXT, validity checking information into 
xcnivtxt, and data into buffers. 



In vtam V3R2, status information, mapped by 
xcnictl, is transferred in the first eight bytes of 
the read buffer, and only one read buffer is 
used. Figure 81 on page 516 illustrates the 
buffer usage in V3R2. 

03 

No-Op 

Causes the channel to respond with a channel 
end or device end. It is the last ccw in a read 
or write chain. 

08 

TIC 

Causes the channel program to execute an 
instruction that is not the next sequential 
instruction within the channel program 
sequence. 

14 

Sense Command 

Byte (SCB) 

The scb is normally issued in response to an 
attention generated when the adapter proc- . 
esses a wctl from the other side. The scb 
clears wctl from the adapter, allowing the 
wctl ccw to complete. 

17 

Write Control (WCTL) 

Causes an attention interruption on the other 
side of the channel-to-channel adapter. The 
wctl is issued to alert the other side that a 
channel program is active at the adapter. 
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Command 

Code 

(hex) 

Command 

Description 

t 

43 

Enable Compatibility 
Mode (ECM) 

Prepares the adapter to operate in 

System/360 (compatibility) mode. The ecm is 
issued when vtam gives up control of the 
adapter. 

C3 

Disable Compatibility 
Mode (DCM) 

Prepares the adapter to operate in 

System/370 (Extended) mode. The dcm is 
issued when vtam acquires control of the 
adapter. 



Figure 81. Buffers Used for Normal Data Transfer in V3R2 

1. The first eight bytes of the read buffer is the control information mapped by 
XCNICTL. 

2. The first eight bytes of the write buffer is the control information mapped by 
XCNOCTL. 
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Channel Programs 

XID Channel Program (X-Side) 

Figure 82 on page 518 shows the data areas associated with the following xid 
channel program. 



ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

1 

Write 

Control 

17 

CC.SLI 

Zero 

1 

2 

TIC 

(Pre-V3R2) 

08 

— 

Write CCW 

— 

3 

Write 

01 

CC.SLI 

XCNOCTL 

8 

4 

Write 

01 

CC.SLI 

PIOPOTXT 

Length of XID 

5 

TIC 

(Pre-V3R2) 

08 

— 

Read CCW 

— 

6 

Read 

02 

CC.SLI 

XCNICTL 

8 

7 

Read 

02 

CC.SLI 

PIOPITXT 

Length of XID 

8 

TIC 

(Pre-V3R2) 

08 

— 

Read CCW 

— 

9 

Read 

02 

CC.SLI 

XCNOVTXT 

4 
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XID Channel Program (Y-Side) 

Figure 83 shows the data areas associated with the following xid channel program. 


Command 

Code 

CCW (hex) Flags Address Count 

1 Sense 14 CC.SLI Zero 1 

Command 
Byte 


2 TIC 08 - Read CCW - 

(Pre-V3R2) 

3 Read 02 CC.SLI XCNICTL 8 

4 Read 02 CC.SLI PIOPITXT Length of XID 


5 TIC 

(Pre-V3R2) 

08 

— 

Write CCW 

— 

6 Write 

01 

CC.SLI 

XCNOCTL 

8 


7 Write 01 CC.SLI PIOPOTXT Length of XID 

8 TIC 08 - Write CCW — 

(Pre-V3R2) 

9 Write 01 CC.SLI SCNOVTXT 4 




=Transfer in Channel 


Figure 83. Data Areas Used for XID Channel Programs (Y-Side) 
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Normal Data Transfer (X-Side) in Pre-V3R2 

Figure 84 on page 521 shows the data areas associated with the X-side of a 
normal data transfer channel program in pre-V3R2 processing. 



ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

1 

WCTL 3 or 

17/ 

CC.SLI 

Zero 

1 


SCB 

14 




2 

TIC 

08 

— 

Write CCW 


3 

Write 

01 

CC.SLI 

XCNOCTL 

8 

4 

TIC 

08 

— 

Write CCW 

— 


Write 

01 

CC.SLI 

Buffer 

Length 


: 


(CD) 



5 

Write 

01 

CC.SLI, 

Buffer 

Length 


: 

01 

(CD) 




Write 


CC.SLI 

Buffer 

Length 


6 

TIC 

08 

— 

Read CCW 

— 

7 

Read 

02 

CC.SLI 

XCNICTL 

8 

8 

TIC 

08 

— 

Read CCW 

— 


Read 

02 

CC.SLI 

Address 
of Data 

Length 

9 

TIC 

08 

— 

Read CCW 

— 


Read 

02 

CC.SLI 

Address of Data 

Length 


TIC 

08 

— 

Write CCW 

— 

10 

Write 

01 

CC.SLI 

XCNOVTXT 

4 


3 wctl is used when this host is initiating a write operation, scb is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Normal Data Transfer (Y-Side) in Pre-V3R2 

Figure 85 on page 523 shows the data areas associated with the following normal 

data transfer channel program. 


Command 

Code 



ccw 

(hex) 

Flags 

Address 

Count 

1 

WCTL 4 or 

14/ 

CC.SLI 

Zero 

1 


SCB 

17 




2 

TIC 

08 

— 

Read CCW 

— 

3 

Read 

02 

CC.SLI 

XCNICTL 

8 

4 

TIC 

08 

— 

Read CCW 

— 


Read 

02 

CC.SLI 

Address 
of Data 

Length 


TIC 

08 

— 

Read CCW 

— 


5 



Read 

02 

CC.SLI 

Address 
of Data 

Length 


TIC 

08 

— 

Write CCW 

— 

6 

Write 

01 

CC.SLI 

XCNOCTL 

8 

7 

TIC 

08 

— 

Write CCW 

— 


Write 

01 

CC.SLI. 

(CD) 

Buffer 

Length 

8 

Write 

01 

CC.SLI, 

(CD) 

Buffer 

Length 


Write 

01 

CC.SLI 

Buffer 

Length 

9 

TIC 

08 

— 

Read CCW 

— 

10 

Read 

02 

CC.SLI 

XCNIVTXT 

4 


4 wctl is used when this host is initiating a write operation, scb is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Normal Data Transfer (X-Side) for V3R2 

Figure 86 shows the data areas associated with the X-side of a normal data 
transfer channel program in V3R2 processing. 


Command 

Code 



CCW 

(hex) 

Flags 

Address 

Count 

1 

WCTL 5 or 

17/ 

CC.SLI 

Zero 

1 


SCB 

14 




2 

Write 

01 

CC.SLI 

YCNWRIDA 

Number of 
bytes to 
transfer 

3 

Read 

02 

SLI 

YCNRDIDA 

Total length 


of Read 
Buffer 


YCNCB 


CH 


( 01 ) 


Tl 


Write CCW 
YCNCCWWR 


( 02 ) 


Read CCW 
YCNCCWRW 


YCNWRIDA 


YCNRDIDA 


List of pointers to 
-► 2K increments of 
Write Buffers 


List of pointers to 
-► 2K increments of 
Read Buffers 


Figure 86. Data Areas Used for Normal Data Transfer (X-Side) in V3R2 


5 wctl is used when this host is initiating a write operation, scb is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Normal Data Transfer (Y-Side) in V3R2 

Figure 87 shows the data areas associated with the following normal data transfer 
channel program in V3R2 


Command 

Code 



CCW 

(hex) 

Flags 

Address 

Count 

1 

WCTL 6 or 

17/ 

CC.SLI 

Zero 

1 


SCB 

14 




2 

Read 

02 

CC.SLI 

YCNRDIDA 

Total length 
of Read 

Buffer 

3 

Write 

01 

SLI 

YCNWRIDA 

Number of 


bytes to 
transfer 


YCNCB 


=c> 


( 01 ) 


Write CCW 
YCNCCWWR 


( 02 ) 


Read CCW 
YCNCCWRW 


YCNWRIDA 


YCNRDIDA 


Figure 87. Data Areas Used for Normal Data Transfer (Y-Side) in V3R2 


List of pointers to 
2K increments of 
Read Buffers 


List of pointers to 
2K increments of 
Write Buffers 


e wctl is used when this host is initiating a write operation, scb is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Channel Programs for Channel-Attached Non-SNA 3270 Devices 

The publications for the non-SNA 3270 devices contain diagnostic procedures. For 
more information, see the 3270 Component Description. 

The ldncb represents local devices and contains addresses and ccws needed for 
channel programs. Figure 88 shows the ldncb and the location in storage of 
various ccws. 


Address of 
Active Request 
Elements 


{ 


Read Buffer 
Length 


Read Modified 
Length 


LDNCB 



Figure 88. Data Areas Used by a Channel Program for Channel-Attached Non-SNA Devices 
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Channel Command Words 

The following channel commands are used by vtam to send data to and to receive 
data from channel-attached non-SNA 3270 terminals. 


Command 

Code 

(hex) 

Command 

Description 

01 

Write 

Transfers data from storage in the host 
processor to the i/o device. Modifies existing 
buffer data. 

02 

Read or 

Read Buffer 

Transfers the entire buffer contents from the i/o 
device to storage in the host processor. 

05 

Erase/Write 

Clears the device buffer before starting the 

Write. 

06 

Read Modified 

Transfers data (that was modified since the last 
Read) from the i/o device to storage in the host 
processor. 

0B 

Select 

Transfers data from the i/o device buffer to the 
controller buffer. Separates the device-to- 
controller unit buffer transfer from the execution 
command. 

0D 

Erase/Write 

Alternate 

Same as Erase/Write, except that it allows for a 
larger buffer size required for some devices. 

IB 

Select Read 
Buffer 

Same as Select, except that it is only used for 
Read Buffer channel programs. 

4B 

Select Write 

Same as Select, except that it is only used for 
Write channel programs. 

OF 

Erase All 
Unprotected 

Clears all unprotected buffers 

11 

Write 

Structured 

Field 

Writes a structured field 
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Channel Programs 

The following tables show the ccws used in various channel programs. The order 
of execution is the same as the order in which they appear. 

Write Data Channel Program 



CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 


Select 

OB or 4B 7 

CC.SLI 

Zero 

1 


TIC 

08 

— 

Write CCW 

— 

As many as 
needed 

Write 8 

01 

CD.SLI 

Output Area 

Length 


7 If the ucb indicates that the device will accept the Select Write, code X '4B', it is used 
until a command reject is received. Then Select, code X 1 OB', is used. 

8 The first Write ccw is pointed to by lonacreq. The last Write ccw is not Command Code 
X'lBV 
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Read Modified Channel Program 



CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 


Select 

OB 

CC.SLI 

Zero 

1 


TIC 

08 

— 

Read Modified 
CCW 


As many 
as needed 

Read 

Modified 9 

06 

CD.SLI 

Input Area 

Length 


TIC 

08 

— 

Ready Modified 
CCW 

Length 


Read 

Modified 10 

06 

CD.SLI 

Input Area 

Length 


Read 

Modified 

(Skip) 

06 

SKIP, 

SLI 

Zero 

X'7FFF‘ 


9 The first Read Modified ccw is pointed to by ldnacreq. 

10 The number of bytes transmitted in the previous Read Modified ccw is stored in the 
ldnrmlen field in the ldncb. For this Read Modified, enough buffers are allocated to hold 
ldnrmlen bytes of data. If this is not enough buffers for the device to send all of the 
pending data, the channel program will end on the Read Skip ccw. The Read Skip ccw 
reads all of the pending data but does not transmit any of it. The new length is stored in 
ldnrmlen. (The length is computed by subtracting the residual byte count in thecsw 
from X'7FFF‘.) Then, the channel program is executed again with enough buffers allo¬ 
cated to read and transmit all of the pending data. 
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Read Buffer Channel Program 


Command 

Code 



CCW 

(hex) 

Flags 

Address 

Count 


Select 

OB or IB 11 

CC.SLI 

Zero 

1 


TIC 

08 

— 

Read Buffer 
CCW 

— 

As many 
as needed 

Read 

Buffer 12 

02 

CD,SLI 

Input Area 

Length 


TIC 

08 

— 

Read Buffer 
CCW 

— 


Read 

Buffer 13 

02 

CD,SLI 

Input Area 

Length 


Read 

02 

SKIP, 

Zero 

X'7FFF' 


SLI 


Buffer 

(Skip) 


11 If the ucb indicates that the device will accept the Select Read, code X'lB 1 , it is used 

until a command reject is received. Then Select, code X 1 OB', is used. 

\ 

12 The first Read ccw is pointed to by ldnacreg. 

13 The number of bytes transmitted in the previous Read Buffer ccw is stored in the 
ldnrblen field in the ldncb. For this Read Buffer, enough buffers are allocated to hold 
ldnrblen bytes of data. If this is not enough buffers for the device to send all of the 
pending data, the channel program will end on the Read Skip ccw. The Read Skip ccw 
reads all of the pending data but does not transmit any of it. The new length is stored in 
ldnrblen. (The length is computed by subtracting the residual byte count in thecsw 
from X'7FFF‘.) Then the channel program is executed again with enough buffers allo¬ 
cated to read and transmit all of the pending data. 
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Erase/Write Channel Program 



CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

As many 
as needed 

Erase/ 

Write 14 

05 

CD.SLI 

Output Area 

Length 


TIC 

08 

— 

Erase/Write 

CCW 

— 


Erase/ 

Write 

05 

SLI 

Output Area 

Length 


Erase/Write Alternate Channel Program 



CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

As many 
as needed 

Erase/ 

Write 1 * 

0D 

CD.SLI 

Output Area 

Length 

Alternate 


TIC 

08 

— 

Erase/Write 
Alternate CCW 

— 


Erase/ 

Write 

0D 

SLI 

Output Area 

Length 


Erase All Unprotected Channel Program 


CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

Erase All 16 

OF 

SLI 

Zero 

1 

Unprotected 






14 ldnacreq has the address of the first Erase/Write ccw. 

15 ldnacreq contains the address of the first Erase/Write Alternate ccw. 

16 ldnacreq contains the address of the Erase All Unprotected ccw. 
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VM VSE BSC Communication Adapter Line Channel Programs 

The bsclb represents a bsc line attached through a bsc communication adapter 
and contains addresses and ccws needed for channel programs. See the IBM 9370 
Information System: Telecommunications Subsystem Description and Reference 
or the IBM 4361 Processor Communication Adapter for a detailed description of 
channel programs, the interface between vtam and the telecommunications sub¬ 
system or communication adapter, and the sense codes returned from a telecom¬ 
munications subsystem or communication adapter. 


vm vse Channel Commands 

The following channel commands are used by vtam to write data to or read data 
from a bsc terminal attached through a communication adapter line. Of the 
channel commands supported by the bsc communication adapter, vtam only uses 
those required for master-station multipoint operations. 


Command 

Code 

(hex) 

Command 

Description 

01 

Write 

Transfers data from storage in the host processor to 
the bsc device. 

02 

Read 

Transfers data from the control unit to storage in the 
host processor. 

03 

No-Op 

Used to stop channel program execution (for example, 
General Poll). It also causes the channel to respond 
with a channel end and device end. 

04 

Sense 

Transfers two bytes of sense data to vtam. 


08 TIC (Transfer Requests a transfer in the channel program. It causes 

in Channel) the channel program to execute a command other 
than the next sequential command in the channel 
program. 


09 

Poll 

Starts the autopoll of the poll list at the entry speci¬ 
fied. 

23 

Set Mode 

Used to condition a line in an Enable Write channel 
program. It sets the desired operating environment. 

27 

Enable 

Sets the bsc line to the enabled state. It is the last 
command in an Enable Write channel program. 

2F 

Disable 

Sets the line to the disabled state. It is a part of the 
Enable Write and Disable channel programs. 


vm vse I/O Scheduling Overview of BSC Lines 

During activation of a bsc line, a polling list is constructed containing entries for all 
of the bsc cluster controllers that are defined for the line. Initially, all the poll list 
entries are inactive and no i/o is started. 
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At the time a Contact ru is processed for the cluster controller, activation proc¬ 
essing activates the appropriate polling list entry and, if it is the first cluster on the 
line to be activated, causes the General Poll channel program to be started. The 
General Poll channel program is designed to run continuously, without interruption 
, as long as negative responses to poll (eots) are being received. When an inter¬ 
ruption occurs, vtam analyzes the non-negative response to determine the next 
action. 

Normally, it would be a Continue Read channel program to acknowledge the pre¬ 
vious response and to solicit the next transmission. The Continue Read channel 
program is issued repeatedly until an eot is received that indicates that the cluster 
controller has completed its data transmission. 

Upon receipt of an eot, the station pending traffic queues are checked for pending 
output to any active terminal on the line. If any is found, that transmission is 
scheduled prior to restarting the General Poll. Any pending activation or deacti¬ 
vation of polling list entries is done at this time as well. 

If output i/o, activation, or deactivation occurs while the General Poll is active, but 
prior to an interruption, the General Poll is stopped to allow this processing to 
proceed. This is accomplished in a controlled manner by changing the tic (the 
sixth command) in the General Poll channel programs to a No-op. Changing the tic 
to No-op causes the channel program to end when it has polled all entries in the 
polling list. 

Following completion of any scheduled operations, the General Poll is restarted at 
the first entry in the polling list. If General Poll is restarted after the completion of 
a General Poll, it is restarted at the next entry from the one that caused the 
General Poll to be completed. This ensures an even distribution of poll operations 
among the cluster controllers on a line. 

The following channel programs are used in the i/o sequence that sends data to or 
receives data from a bsc terminal. 

Note: Except for the Enable Write and Disable Write channel programs, all of the 
channel programs (or portions of them) are in the bsclb (bsc line control block). 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Appendix B. Channel Programs 


533 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


VM VSE Channel Programs 

The following tables illustrate the ccws used in various channel programs. 


VM VSE Enable Write Channel Program 

This channel program is started for actlink processing in order to condition and 
enable the line. 


No. 

ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Disable 

2F 

CC.SLI 

— 

1 

(2) 

Set Mode 

23 

CC.SLI 

Control 

Information 

1 

(3) 

Enable 

27 

SLI 

— 

1 


VM VSE Disable Write Channel Program 

This program is started for dactlink processing in order to disable a line. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Disable 

2F 

SLI 

— 

1 
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vm vse General Poll (Initial Read) Channel Program 

To solicit data from bsc terminals, this program is constructed to allow polling to 
begin with any entry in the poll list and to continue wrapping through the list until: 

• A non-negative response is received from a terminal. 

• The channel program is stopped for the scheduling of output. 

• The operations terminate. 

The program also is updated dynamically to reflect a changed poll list entry, poll 
list length, or read data area. When this program is initiated, the bscocfsm, 
bscpcfsm, and bscccfsm fields of the bsclb are set to X 1 01 1 . 


No. 

ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(1) 

Write 

01 

CC,SLI 

EOT 

1 

(2) 

Poll 

09 

CC,SLI 

Poll list entry 

n + 1 

(3) 

TIC 

08 

— 

Command (5) 

1 

(4) 

TIC 

08 

— 

Command (7) 

1 

(5) 

Poll 

09 

CC.SLI 

First entry 
poll list 

m + 1 

(6) 

TIC 

08 

— 

Command (5) 

1 

(7) 

Read 

02 

SLI 

I/O buffer 

Length 


VM VSE Continue Read Channel Program 

This program is used after either an Initial Read channel program or another Con¬ 
tinue Read channel program. It sends a positive acknowledgment to previously 
received data and to read in additional data. When this program is executing, the 
bscocfsm, bsccpfsm, and bscccfsm fields of the bsclb are set to X 1 02 1 . 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(i) 

Write 

01 

CC.SLI 

ACKO or ACK1 

2 

(2) 

Read 

02 

SLI 

I/O buffer 

Length 
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VM VSE Repeat Read Channel Program 

During error recovery procedure (erp) for bsc lines, this channel program is exe¬ 
cuted to request that the terminal retransmit the previous text block in which a 
"block check" error was detected. At this point, the bscocfsm, bscpcfsm, and 
bscccfsm fields of this bsclb are set to X 1 OB 1 . 


No. 

ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Write 

01 

CC,SLI 

NAK 

1 

(2) 

Read 

02 

SLI 

I/O Buffer 

Length 


vm vse Interrupt Write Channel Program 

When the inbound data flow must be stopped immediately, the Interrupt Write 
channel program is used to stop the General Poll (Initial Read) channel program. 
In order to prevent data loss, the channel program is executed following a text 
block that ends with etx. The bscccfsm and bscpcfsm fields of the bsclb are set to 
X'OC'. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Write 

01 

CC.SLI 

RVI 

2 

(2) 

Read 

02 

SLI 

Response area 

2 


VM VSE Reset Write Channel Program 

The Reset Write channel program is used to write an eot to the terminal and to 
return the line to control mode. When this program is executing, the bscccfsm and 
bscpcfsm fields of the bsclb are set to X 1 07'. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(i) 

Write 

01 

SLI 

EOT 

1 
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v- vss Status Read Channel Program 

The Status Read channel program is executed when a terminal indicates that it has 
pending bsc sense/status information. The program specifically polls the terminal 
and reads the bsc sense/status information only. The bscccfsm and bscpcfsm fields 
of the related bsclb are set to X'OA 1 . 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Write 

01 

CC.SLI 

EOT 

1 

(2) 

Write 

01 

CC.SLI 

Specific poll 

5 





characters 


(3) 

Read 

02 

SLI 

I/O buffer 

Length 


Vi , V3E Inquiry Read Channel Program 

The Inquiry Read channel program clears a communication adapter line buffer. 
Any data read is discarded because of the skip flag in the program’s Read ccw. 
The bscccfsm and bscpcfsm fields of the bsclb are set to X'OD'. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(1) 

Read 

02 

SLI,SKIP 

Response area 

4095 


, VSii Sense Channel Program 

The Sense channel program is issued when vtam receives unit-check status from 
the communication adapter. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(i) 

Sense 

04 

SLI 

Sense area 

2 
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vm vse Initial Write (Conversational) Channel Program 

A variation of the Initial Write channel program, the Initial Write (Conversational) 
channel program performs a required conversational function. This function allows 
a terminal to respond to a text block with another text block, rather than with a 
response. The channel program must have an appropriate length buffer ready to 
receive the text block. The bscocfsm. bscccfsm, and bscpcfsm fields of the bsclb 
are set to X'08 1 when an Initial Write (Conversational) channel program is exe¬ 
cuting. They are set to X'04 1 when an Initial Write channel program is executing. 


No. 

ccw 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(i) 

Write 

01 

CC.SLI 

EOT 

1 

(2) 

Write 

01 

CC.SLI 

Selecting characters 

5 

(3) 

Read 

02 

SLI 

Response area 

2 

(4a) 

Write 

01 

CD,SLI 

STX ESC characters 

2 

(4b) 

TIC 

08 

— 

Command (4c) in I/O buffers 

1 

(4c) 

Write 

01 

CD,SLI 

Data in I/O buffer 

Length 

(4d) 

TIC 

08 

— 

Command (4e) 

1 

(4e) 

Write 

01 

CC.SLI 

ETX character 

1 

(5a) 

Read 

02 

SLI 

Response area 

2 

(5b) 

Read 

02 

SLI 

I/O buffers 

Length 


VM VSE Inquiry Write (Conversational) Channel Program 

The Inquiry Write channel program is issued during erp (error recovery procedure) 
in order to request the terminal to retransmit its last response. The bscccfsm and 
bscpcfsm fields of the bsclb are set to X 1 06'. 


No. 

CCW 

Command 

Code 

(hex) 

Flags 

Address 

Count 

(D 

Write 

01 

CC.SLI 

ENQ 

1 

(2a) 

Read 

02 

SLI 

Response area 

2 

(2b) 

Read 

02 

SLI 

I/O buffer 

Length 
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vm vse Channel Program Finite State Machines for BSC Lines 

The finite state machine (fsm) represents what is happening on the bsc line. The 
following table shows the finite state machines and what they mean. 


FSM 

State 

Explanation 

(1)GP 

General Poll 

The General Poll channel program is executing. 

(2) CR 

Continue Read 

The Continue Read channel program is exe¬ 
cuting. 

(3) CM 

Control Mode 

The bsc line is in control mode. No channel 
program is executing for the line. 

(4) IW1 

Initial Write 1 

The first part of an Initial Write channel program 
is executing. 

(5) IW2 

Initial Write 2 

The second part of an Initial Write channel 
program is executing. 

(6) INQ 

Inquiry Write 

An Inquiry Write channel program is executing. 

(7) EOT 

End of Trans¬ 
mission 

An eot has been sent, or an eot is expected. 

(8) IC1 

Initial Write Con¬ 
versational 1 

The first part of an Initial Write Conversational 
channel program is executing. 

(9) IC2 

Initial Write Con¬ 
versational 2 

The second part of an Initial Write Conversa¬ 
tional channel program is executing. 

(10) STR 

Status Read 

A Status Read channel program is executing. 

(11) RR 

Repeat Read 

A Repeat Read channel program is executing. 

(12) IWT 

Interrupt Write 

An Interrupt Write Channel program is executing. 

(13) IQR 

Inquiry Read 

An Inquiry Read channel program is executing. 

(14) IQW 

Inquiry Write Con¬ 
versational 

An Inquiry Write Conversational channel 
program is executing. 


Figure 89 on page 540 shows the finite state machines representing activity on a 
bsc line. 

At the top of each column is the state that the line is in. The state is one of the 
following: 

• The channel program that is executing for the line 

• The condition of the line 

• An end of transmission (eot). 

Above the arrow are the stimuli (flags, responses) that cause a state change. At 
the end of the arrow is the new state or a number that refers to a new state (the 
number at the top of a column). Below the arrow is the action that vtam takes as a 
result of the state change: the action may be to send a response, to issue an ru 
such as a station inop or an exception request, or to set up a procedure to delay 
processing until a temporary condition has ended. 
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The following abbreviations are used in the diagrams: 

ACKO Positive acknowledgement 0; alternates with acki 

ACK1 Positive acknowledgement 1; alternates with acko 

ENQ Enquiry; requests a reply 

EOT End of transmission 

ETB End of test block 

ETX End of text 

NAK Negative acknowledgment 

RVI Reverse interrupt 

SOH Start of heading 

STX Start of text 

TRM Test request message 


(D GP 

STX-ETB 
STX-ETX 


Gen Inbound 
Request 

SENSE STATUS 

-► 


Process 

Response 

No Buffer 


-► 02 ) 

Set Up for 
Delayed Read; 
Gen Exception 
Request 

TRM 


Gen Inbound 
Request 


Should-Not- 
Occur (Retry) 
-( 11 ) 


Retry Limit 
Exceeded 


Process 
Station Inop 


(3) 


(2) CR 

STX-ETB 
STX-ETX 


Gen Inbound 
Request 


SENSE STATUS 


Process 

Response 


No Buffer 


-► 02 ) 

Set Up for 
Delayed Read; 
Gen Exception 
Request 

TRM 



EOT 


Should-Not- 
Occur (Retry) 
-► ( 11 ) 


Retry Limit 
Exceeded 

Process 
Station Inop 


(3) CM 



(4) IW1 


ACKO 


RVI 


Retry Limit 
Exceeded 

-► (7) 

Gen Negative 
Response 


Send Outbound 
Text 


( 10 ) 


Should-Not- 
Occur (Retry) 


(5) IW2 


ACKI 


► (7) 
Gen Positive 
Response 

ACKO (Retry) 


ACKO/NAK 
(Retry Limit 
Exceeded) 

-► (7) 

Gen Negative 
Response 


NAK (Retry) 


Should-Not- 
Occur (Retry) 


Retry Limit 
Exceeded 

—-► (7) 

Gen Negative 
Response 


(6) INQ 


ACKI 


Gen Positive 
Response 

ACKO/NAK 


► (9) 


NAK 


Should-Not- 
Occur (Retry) 


Retry Limit 
Exceeded 


Gen Negative 
Response 


(7) EOT 


Figure 89 (Part 1 of 2). Finite State Machines for BSC Lines 


540 VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 



"Restricted Materials of IBM” 

Licensed Materials - Property of IBM 


(8) IC1 


(9) IC2 
STX-ETX 


(10) STR 


(11) RR 


(12) IWT 


-► -► ( 2 ) 

Send outbound Gen Inb Re¬ 
text quest, Pos 

Request 

RVI STX-ETB 

-►( 10 ) -► ( 2 ) 

Gen Inbound 
Request 


S0H,%,R,STX-ETX STX-ETX 

-► ( 2 )- 

Gen Response or Gen Inb I 
Excep Request quest, Po 


Gen Inb Re¬ 
quest, Pos 
Response 


No Buffer 
-► 

Set Up for 
Delayed Read 


Should-not- No Buffer Should-not-Occur 

Occur (Retry) -:—► (12) -► (7) 


Retry Limit 
Exceeded 

-► (7) 

Gen Negative 
Response 


Set Up for 
Delayed Read; 
Gen Pos Re¬ 
sponse; Gen 
Excep Request 

STX-ENQ 

SOH-ENQ 

(Retry) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 

-►( 

Process 
Station Inop 

NAK (Retry) 


Gen Neg Response 


STX-ETB 

-► ( 2 ) 

Gen Inbound 
Request 

No Buffer 

-► ( 12 ) 

Set Up for 
Delayed Read; 
Gen Pos Re¬ 
sponse; Gen 
Excep Request 

STX-ENQ 

SOH-ENQ 

(Retry) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 

-►(: 

Process 
Station Inop 

NAK (Retry) 


Should-not- 

Occur 

-► (7) 


(13) IQR 

CE/CD, Initial 
ERR = Lost Data, 
Retry 

-► ( 11 ) 

CE/DE, Initial 
ERR = Lost Data, 
Retry Exceeded 

-► (3) 

Station Inop 

UE or Timeout 

-► n 

Restart Prev 

Channel 

Program 


(14) IQW 

STX-ETX 
-► 

Gen Inb Re¬ 
quest, Pos 
Response 

STX-ETB 

-► ( 2 ) 

Gen Inbound 
Request 

No Buffer 

-► ( 12 ) 

Set Up for 
Delayed Read; 
Gen Exception 
Request 


STX-ENQ 

SOH-ENQ 

(Retry) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 

-► (2 

Process 
Station Inop 

NAK (Retry) 


NAK (Retry 
Limit Exceeded) 

-»(7) 

Gen Negative 
Response 

TRM 

-^( 2 ) 

Gen Inbound 
Request 
Gen Posistive 
Response 


Should-not- 

Occur 

-^( 7 ) 

Gen Negative 
Response 


NAK (Retry 
Limit Exceeded) 

-► (7) 

Gen Negative 
Response 

TRM 

-*( 2 ) 

Gen Inbound 
Request 
Gen Positive 
Response 


Should-not- 

Occur 

- ►(7) 

Gen Negative 
Response 


TRM 

-► ( 2 ) 

Gen Inbound 
Request 
Gen Positive 
Response 

ENQ 

(Retry) 


ENQ 

(Retry) 

- » 

Gen Negative 
Response 


Should-not- 

Occur 

-► (7) 

Gen Negative 
Response 


Figure 89 (Part 2 of 2). vm VSE Finite State Machines for BSC Lines 
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e Channel Programs for an SDLC Communication Adapter Line 

The halcb represents an sdlc line attached through an sdlc communication 
adapter and contains addresses and ccws needed for channel programs. See the 
IBM 9370 Information System: Telecommunications Subsystem Description and 
Reference or the IBM 4361 Processor Communication Adapter for a detailed 
description of channel programs, the interface between vtam and the telecommuni¬ 
cations subsystem or communication adapter, and the sense codes returned from 
a telecommunications subsystem or communication adapter. 


se Channel Commands 

The following channel commands are used in the channel programs to communi¬ 
cate with sna devices on sdlc lines or with the sdlc lines themselves. 


Command 

Code 

(hex) 

Command 

Description 

01 

Write 

Writes an sdlc command located in the tscodata 
field of theTSCB. 

02 

Read 

Reads an sdlc command or control data located 

at TSCIDATA. 

03 

No-op 

Used to stop channel program execution. 

05 

Write PIU 

Points to tscilng, a two-byte prefix to tscpiu. 
tscilng contains the total length of the data in the 
piu. This length includes the th, rh, ru, and 
tscilng. Data in any continuation buffers for the 
Write PIU channel program will start at tscpiu as 
usual. 

06 

Read PIU 

Points to tscilng, a two-byte prefix of tscpiu. The 
total length of the data is returned in tscilng. 

Data in any continuation buffers of the Read piu 
channel program begins at tscilng. 

08 

TIC 

(Transfer 

in 

Channel) 

Requests a transfer in the channel program. It 
causes the channel program to execute a 
command other than the next sequential 
command in the channel program. 

09 

Autopoll 

Points to a polling list of scbs. The length is the 
length of the polling list. This command solicits 
input from active stations, contact polls those 
stations being activated, and ignores the inactive 
stations. 

0B 

Control SCB 
(Control SPL) 

Transfers 12 bytes of scb information from vtam 
to the communication adapter. 
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Command 

Code 

(hex) 

Command 

Description 

OF 

Poll 

Transfers a final rr or rnr after a chain of Write 

P commands. When the Poll command is exe¬ 
cuted, the line is turned to inbound. 

14 

Sense SCB 
(Sense SPL) 

Retrieves the current scb from the communi¬ 
cation adapter after a line operation completes. 
The current scb indicates which station 
responded. 

23 

Set Mode 

Transfers up to 8 bytes of setmode data to the 
communication adapter to change the status of a 
line. 

27 

Enable 

Makes the line operational. 

29 

Dial 

Transfers dialing data to the automatic calling 
unit (acu). 

2F 

Disable 

Makes the line non-operational. 

E4 

Sense I/O 

Transfers up to 7 bytes of line configuration 
information from the communication adapter. 


vm vse I/O Scheduling Overview of SDLC Lines 

During activation of an sdlc line, a station polling list (spl) is constructed con¬ 
taining entries for all the physical units that are defined for the line. Initially, all the 
station entries are inactive. When any station has to be contacted and it is the first 
station on the line to be activated, the Autopoll channel program is started to do a 
Contact Poll. When a station sends in a nonsequenced acknowledgment (nsa), data 
polling begins. 

The Autopoll channel program is designed to run continuously, without inter¬ 
ruption, as long as Receive Ready (rr) or Receive Not Ready (rnr) responses flow. 
The Autopoll channel program is interrupted when sdlc supervisor frames or infor¬ 
mation frames are received, when data is to be transmitted, or when certain pu 
services i/o has to be processed. In order to send the Write data, the Autopoll 
channel program is interrupted by changing the third ccw, which is a No-op, to a tic 
ccw pointing to the Write piu channel program. 

The Write buffers to be transmitted are pointed to by a pending queue (putpendq), 
or an error hold queue (putehold), in the put entry. The sdlc station scheduler 
scans every put entry, starting from the current entry indicated in halcuscb, and 
passes the Write buffers toTSC’s sdlc channel program build routine. 

If there is no Write data to be sent to any station, the Autopoll is restarted. The 
communication adapter begins polling from the next station in the station polling 
list unless the polling index is changed by the Set Mode ccw. One pass of the 
Autopoll channel program is restarted if a Read Error ccw occurs on one of the 
stations. This is accomplished by changing the tic ccw after the Autopoll ccw to a 
No-op. 
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VM VSE I/O Scheduling for PU Services 

All pu services requests are processed by the sdlc connection manager outbound 
(isttscho) on the pu services pab in the halcb (ncbpupab). Before initiating i/o for pu 
services, a switch is set to wait for current i/o (including the Autopoll channel 
program) to finish. This is done by setting the state of pu services i/o (halpusio) to 
pending, which signals the channel end not to restart application program i/o or 
Autopoll after the completion of the current i/o. The continuous Autopoll channel 
program is broken by changing the third ccw, which is a No-op, to a tic ccw 
pointing to another No-op. 

When the current i/o has been completed, the state of pu services i/o is set to 
“halted," and the connection manager processes the request and schedules i/o. 

The state of pu services i/o changes to “active." The state changes to “inactive" 
after the completion of i/o. 

The connection manager builds its channel program in a buffer (at tscpccw). 

VM VSE I/O Scheduling for the Link Level 2 Test 

A testmode request is initiated and completed by the sdlc connection manager out¬ 
bound routine (isttscho) on the pu services pab in the halcb (ncbpupab). The link 
level 2 test is executed by channel end and the link scheduler. 

If the testmode request is to start a link level 2 test, the sdlc connection manager 
outbound routine sets the station to “test mode,” initializes fields in the put entry, 
obtains storage for the write and read buffers, moves the specified data into the 
write buffer, and starts the Write Test channel program. The Write Test channel 
program is repeated the specified number of times, or until the test is canceled by 
the operator. 

If the testmode request is to cancel a current test, a rectr request is built and sent 
to network operator services to that the operator message with the test results can 
be built. 


VM VSE Channel Programs 

The following channel programs are used in i/o sequences that send data to or 
receive data from devices on nonswitched and switched sdlc lines. 

Note: The Autopoll channel program (a part of the Write piu channel program) and 
the Sense scb channel program are in the halcb (HALCHPGM). The other channel 
programs are formatted in i/o buffers. 


VM VSE Autopoll Channel Program 

The Autopoll channel program is used to solicit data from active stations (data poll) 
and to check whether inactive stations are ready to be activated (contact poll). 
When the Autopoll ccw is executed, the communication adapter steps through the 
sdlc polling list table (spl table; scb table to the communication adapter) and 
sends either a data poll or a contact poll until one of the following occurs: 

• An active station responds with data. 

• An inactive station responds with a nonsequenced acknowledgment (nsa). 

• An error occurs. 
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• vtam changes the tic address of point to a Write PIU channel program or to a 
No-op ccw to stop the Autopoll channel program. 

If ail responses to the polls are negative, the final tic chains to the second ccw (the 
No-op) to start another poll pass through the spl table. 


CCW 

Command 

Code 

(hex) 

Flags 

Description 

Remarks 

Set Mode 

23 

CC.SLI 

Sets the desired operating mode. 

Optional 

No-Op 

03 

CC.SLI 

Required as the last in a chain. 


TIC 

08 


When polling, transfers control to 
the Autopoll ccw immediately fol¬ 
lowing the tic. For a Write 
channel program, either transfers 
to a string of Write Pius or to a 
No-Op ccw to stop Autopoll. (See 
the Write piu channel program.) 


Autopoll 

09 

CC.SLI 

Starts polling, points to the spl 
table, sends Receive Ready (rr) 
for data poll or Set Normal 
Response Mode (snrm) for 
contact poll depending upon the 
flag settings in the spl. 


TIC 

08 


Transfers back to the second 
command (No-Op) to continue 
polling, is changed to No-Op if 
continuous Autopoll is not 
required (for example, when an 
error occurs on a Read ccw), and 
transfers to a Write Test channel 
program when LL2 test is 
required. 


TIC 

08 


Is executed when status modified 
is given to the channel by the 
communication adapter and 
transfers to Read piu or Sense 
scb channel program. 
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VM VSE Read PIU Channel Program 

The Read piu channel program reads data sent to vtam by another sdlc station. 
Normally, the channel program is started when an Autopoll tic points to the first 
Read piu buffer. The Read piu ccws are built in the buffers that will receive the data 
and are chained together by tics. The number of buffers in the chain is determined 
by the values for the inbfrs operand of the line's definition statement. 

When vtam is a secondary link station or when the line is in an inbound direction, 
the communication adapter starts the Read piu channel program with the Control 
scb ccw that is located in the halcb. 

When the transmission is complete or when the communication adapter detects 
error information, the communication adapter skips over any remaining Read piu 
ccws to a Sense ccw by which it can report error information. 

The Read piu channel program is pointed to by the Autopoll channel program 
unless it starts with a control scb ccw. 


CCW 

Command 

Code 

(hex) 

Flags 

Description 

Remarks 

Control SCB 

OB 

CC.SLI 

Used only when vtam is a 
secondary link station, the 
line is in an inbound direc¬ 
tion, and the Autopoll 
channel program is not used 
to point to the first Read ccw 
in the halcb. 

Optional 

TIC 

08 

— 

Points to the first Read piu in 
the HALCB. 

Optional 

Read PIU 

06 

CC.SLI 

Points to the input area. 


TIC 

08 

— 

Points to the next Read piu 

ccw. 





Read PIU 

06 

CC.SLI 

Points to the input area. 


TIC 

08 

— 

Points to the Sense scb ccw 
that is in the halcb. 
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vm vsEWrite PIU Channel Program 

The Write piu channel program sends data to another sdlc station. Normally, the 
channel program is started when an Autopoll tic points to the first Write piu buffer. 
The Write PIU ccws are built in the buffers that contain the outbound data. After the 
data in the last buffer is sent to the station, the program executes a Poll ccw that 
sends rr (Receive Ready) so that the station may acknowledge receipt of the data 
and, optionally, may send any waiting data. The final tic points to the Read piu 
channel program in order to receive possible inbound data and to verify that the 
outbound data was received. 

The Write piu channel program is pointed to by the Autopoll channel program in the 

HALCB. 


CCW 

Command 

Code 

(hex) 

Flags 

Description 

Control SCB 

OB 

CC,SLI 

Points to an spl entry. 

TIC 

08 

— 

Points to the first Write piu in the halcb. 

Write PIU 

05 

cc 

Points to the buffer containing the piu to 


be sent. Even when the data is spanned 
in more than one buffer, the ccws are 
command chained. 


TIC 

08 

— Points to a Write piu ccw if there are 

more Pius, or points to a Poll ccw if the 
last piu has been sent. 




Poll 

OF 

CC.SLI Starts polling at the next entry in the spl. 

TIC 

08 

— Points to a Read piu or Sense scb ccw. 
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vm vse Writ© Test Ch3nn©l Program 

The Write Test channel program sends and receives test frames. It is used when a 
link level 2 test is requested. The Write Test channel program is pointed to by the 
Autopoll channel program or by ncbcaw in the halcb. 



Command 




Code 



ccw 

(hex) 

Flags 

Description 

Write 

01 

CC.SLI 

Points to data in the Write buffer. 

Read 

02 

SLI 

Points to the Read buffer. 


vm VSE Sense SCB Channel Program 

The Sense scb channel program is used to retrieve completion status from the 
communication adapter. The Sense scb ccw is the last ccw in the chain for channel 
programs that perform normal data transfer for the Autopoll channel program, the 
Read piu channel program, or the Write sdlc Control channel program. 



Command 




Code 



CCW 

(hex) 

Flags 

Description 

Sense ccb 

14 

SLI 

Points to an input area (halcuscb). 


VM VSE Sense I/O Channel Program 

The Sense i/o channel program requests and receives line configuration informa¬ 
tion from the communication adapter. This information is used to verify informa¬ 
tion in the line’s definition statement. The verified information is included in the 
line’s obr record for the line. For this channel program, the hallfsm field of the 
halcb is set to X'01'. 



Command 



Code 


ccw 

(hex) Flags 

Description 

Sense I/O 

E4 - 

Points to an input area used to obtain the 
line configuration. 
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vm vse Enable Line Channel Program 

The Enable Line channel program is used when a nonswitched line is activated. 
When this channel program is being executed, the hallfsm field in the halcb is set 
toX'02'. 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Disable 

2F 

CC.SLI 

Sets the line to disable state and clears 
certain pending status conditions. 

Set Mode 

23 

CC,SLI 

Tells the communication adapter how 
vtam expects to use the line and sets 
operating values such as timeout values 
and control indices. Desired operating 
mode values are contained in the 
halsmode field in the halcb. 

Enable 

27 

SLI 

Causes the communication adapter to 
make the dce interface ready. For ccitt 
v.24 or eia RS-232C, Enable means acti¬ 
vating the Data Terminal Ready (dtr) line 
and verifying that the response is Data 

Set Ready (dsr). 
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vm vse Answer Channel Program 

The Answer channel program is used when a switched line is activated. When a 
call is received, vtam checks information in the xid response against values in the 
corresponding switched line’s definition statement. Based on that information, 
vtam either accepts or rejects the call. For this channel program, the hallfsm field 
in the halcb is set to X 1 01'. 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Disable 

2F 

CC.SLI 

Sets the line to disable state, clears 
certain pending status conditions, and 
breaks any outstanding switched con¬ 
nections. 

Set Mode 

23 

CC.SLI 

Tells the communication adapter how 
vtam expects to use the line and sets 
operating values such as control indices. 
The desired operating mode is contained 
in the halsmode field in the halcb. 

Enable 

27 

CC.SLI 

Causes the communication adapter to 
make the dce interface ready. This ccw 
is not completed until an incoming call is 
accepted, so it may be active for a long 
time before it completes with the Data 
Terminal Ready (dtr) sequence. 

Write 

01 

CC.SLI 

Points to the area containing all station 
identifiers and xid commands (tscodata). 

Read 

02 

SLI 

Points to an input area (tscidata). 
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vm vsEDial Channel Program 

The Dial channel program is identical to the Answer channel program except that a 
Dial ccw is used to initiate an outbound call (an Enable ccw is used to receive an 
inbound call). Execution of the Dial ccw transfer the desired telephone number to 
the communication adapter which forwards the number, one digit at a time, to an 
autocall adapter. The hallfsm field in the halcb is set to X'02' when this program 
is active. 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Disable 

2F 

cc.su 

Sets the line to disabled state. 

Set Mode 

23 

CC.SLI 

Sets the desired operating mode as spec¬ 
ified in HALSMODE. 

Dial 

29 

CC.SLI 

Points to an area (tscpdata) containing 
the digits to be dialed. 

Write 

01 

CC.SLI 

Points to the area containing all station 
identifiers and xid commands (tscodata). 

Read 

02 

SLI 

Points to an input area (tscidata). 


VM VSE Write SDLC Control Channel Program 

The Write sdlc Control channel program is used when tam is the secondary station 
(for example, as in a vtam-ncp connection). This channel program sends a nonse- 
quenced acknowledgment (nsa) in response to a Set Normal Response Mode 
(snrm) from a Contact Poll or in response to a Discontact (disc) sent during shut¬ 
down processing. 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Set Mode 

23 

CC.SLI 

Sets the desired operating mode. 

Write 

01 

CC.SLI 

Points to an output area (tscodata) and 
will be changed to a No-Op ccw when 
closedown recording is required for the 
physical unit. 

TIC 

08 


Transfers to the Sense scb ccw that is in 
the halcb, causing the communication 
adapter to wait for some transmission 
from the primary station. 
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vm vse Read SDLC Control Channel Program 

Like the Write sdlc Control channel program, the Read sdlc Control channel 
program is used when vtam is the secondary station. It waits for the Set Normal 
Response Mode (snrm) sent by the primary station on a Contact Poll. 

The Read sdlc control program can be pointed to by the Enable Line channel 
program. 



Command 

Code 



ccw 

(hex) 

Flags 

Description 

Set Mode 

23 

CC,SLI 

Sets the desired operating mode in the 
halsmode field in the halcb. It can be a 
Write ccw or No-Op ccw, if required. 

Read 

02 

— 

Reads an sdlc command. 


vm vse Disable Line Channel Program 

The Disable Line channel program sends a Disable ccw to shutdown the modem 
interface of the communication adapter. 



Command 




Code 



CCW 

(hex) 

Flags 

Description 

Disable 

2F 

SLI 

Sets the line to disabled state. 


vm vse Primary XID Channel Program 

The Primary xid channel program is for a communication adapter-attached type 5 
physical unit (xid Exchange). 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Contents 
of Address 

Field 

Set Mode 

23 

CC.SLI 

Changes the timeout 
value. 

HALSMODE 

Write 

01 

CC.SLI 

Transfers the xid(00) 
from this host to the 
communication 
adapter-attached host. 

Output Area 

Read 

02 

SLI 

Reads an sdlc 

command. 

Input Area 
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VIVl V£ 


e Secondary XID Channel Program 

The Secondary xid channel program is for a communication-adapter-attached type 
4 physical unit (xid Exchange). 


ccw 

Command 

Code 

(hex) 

Flags 

Description 

Contents 

of Address 

Field 

Disable 

2F 

CC,SLI 

Makes sure that the 
line direction is out¬ 
bound. 


Set Mode 

23 

CC.SLI 

Changes the timeout 
value. 

HALSMODE 

Enable 

27 

CC.SLI 

Causes the communi¬ 
cation adapter to make 
the dce interface 
ready. For ccitt v.24 
or eia RS-232C, Enable 
means activating the 
Data Terminal Ready 
(dtr) line and verifying 
that the response is 

Data Set Ready (dsr). 


Read 

02 

SLI 

Reads an sdlc 
command. 

Input Area 
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vm vseLink, Connection, and Physical Unit Finite State Machines 

If an error occurs during the activation or deactivation of the sdlc link or of a phys¬ 
ical unit, the finite state machines can be used to determine the state of the link or 
station. 


vm vsELink State Machine Values 

00 Reset 

01 Sense i/o pending 
02 Enable pending 
08 Active 
10 Halt i/o pending 
20 dactlink disable pending 
30 inop disable pending 
40 actlink disable pending 


vm vsEConnection State Machine Values 

00 Reset 

01 Answer pending 
02 Auto dial pending 
04 Manual dial pending 
08 Connected 

10 Abandon Connection 1 

11 Abandon Connection 2 
21 dactconnin pending 

41 Abandon Connect Out pending 

vm vsEPhysical Unit State Machine Values 

00 Reset 

01 Contact pending 
03 Pending Discontact pending 
04 xid pending 

10 Active 

11 Test Mode 

21 Request Discontact (rqd) received 

22 Discontact pending 

23 Pending reset 

31 Secondary Contact pending 

32 Secondary Set Normal Response Mode (snrm) received 

39 Primary/Secondary contention 

40 Secondary active 
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51 Secondary Discontact pending 
56 obr pending inop 
58 obr pending Contacted 
60 obr pending Discontact 

vm vse Hints for Common Errors: Finite States 

If an error occurs, the finite state in the put (putfsm) and in the halcb (halfsm) 
should be checked to find the state at which the error occurred. The finite state 
machine diagrams below show the actions occurring as a result of various inputs 
for the finite state machine values. 

The sex in halcb (halcuscb) contains the status for the last physical unit for which 
i/o was active. 

The sense field in halcb (ncbsense) contains the sense data as a result of a unit 
check on the line. 

The state of pu services i/o (halpusio) indicates whether or not the connection 
manager was doing i/o. 

The ncbpoll flag, if on, indicates that the line is polling. If off, it indicates that 
either Write i/o or connection manager i/o is in progress. 

The ncbready flag, if on, indicates that the link is active. 

ncblinop indicates a permanent link error. 

ncbsinop indicates a permanent station error. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Appendix B. Channel Programs 555 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


vs SDLC Finite State Machines 

The finite state machine diagrams (Figure 90 on page 557 through Figure 93 on 
page 560) show how vtam handles pu services requests and responses for its sdlc 
support. The requests shown are as follows: 


PU Services 

Request 

State Diagram 

ABCONN 

Connection (Figure 91 on page 558) 

ABCONNOUT 

Connection (Figure 91 on page 558) 

ACTCONNIN 

Connection (Figure 91 on page 558) 

ACTLINK 

Line (Figure 90 on page 557) 

CONNOUT 

Connection (Figure 91 on page 558) 

CONTACT 

Station (Figure 92 on page 559 and Figure 93 on 
page 560) 

DACTCONNIN 

Connection (Figure 91 on page 558) 

DACTLINK 

Line (Figure 90 on page 557) 

DISCONTACT 

Station (Figure 92 on page 559 and Figure 93 on 
page 560) 

TESTMODE 

Station (Figure 92 on page 559) 


The diagrams show the following: 

• The request or event (above the line). 

• The action taken (under the line). For example, a channel program generated 
or the response given to pu services as a result of the event. 

• The transition (direction of the line) to the next state. 
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Figure 90. vm vsELine Finite State Machine 
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Figure 91.vmvse Connection Finite State Machine 
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Figure 93. VM VSE Primary Station Finite State Machine 
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Appendix C. Network Flows 

This appendix describes the flow of vtam rus and amrus between network address¬ 
able units, first single network flows and then cross-network flows. The diagrams 
are divided into the following categories: 

• Activation 

• Session Establishment 

• Deactivation and Session Termination 

• Error Recovery Processing (erp) and Management Services 

For certain session establishment rus (actcdrm, actpu, actlu, and bind), additional 
rus can flow if the explicit route (er) or virtual route (vr) selected for a session is 
not active. Because this flow is essentially the same for all four rus, these rus are 
referred to as generic bind (gbind) amrus. To avoid repetition, the flows for these 
amrus are shown once at the beginning of this appendix. 
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Single Network Flows 

Activation Flows 

GBIND AMRUs: Figure 94 on page 566 through Figure 97 on page 567 show the 
flow of requests and responses between the sscp and logical and physical units 
when a vr or er selected for a session is not yet active. 

• Sending an actpu request for a communication controller or physical unit 
(Figure 94 on page 566) 

• Sending an actlu request for a logical unit (lu; Figure 95 on page 566) 

• Sending a bind request to a secondary logical unit (slu; Figure 96 on 
page 567) 

• Activating a virtual route (Figure 97 on page 567) 

Resource Activation: Figure 98 on page 568 through Figure 113 on page 581 
show the flow of requests and responses between the sscp and logical and phys¬ 
ical units to activate resources. 

• Activating an ncp major node (Figure 98 on page 568 and Figure 99 on 
page 569) 

• Activating the resources controlled by a host or ncp major node (Figure 100 on 
page 570 through Figure 111 on page 580) 

• Takeover of a Type 2.1 peripheral node logical unit (Figure 101 on page 571) 

- Activating a connection to a host or ncp (Figure 100 on page 570 through 
Figure 104 on page 574) 

- Activating a physical unit (Figure 105 on page 575 and Figure 106 on 
page 575) 

— Moving the address of a physical unit (Figure 105 on page 575, Figure 107 
on page 577, and Figure 108 on page 578) 

- Takeover of a T 2 .i Node logical unit upon physical unit activation 
(Figure 109) 

- Activating a logical unit (Figure 110 on page 580 and Figure 111 on 
page 580) 

- Activating an application program/Opening an acb (Figure 111) 

• Activating a cdrm (Figure 112 on page 581 and Figure 113 on page 581) 

Session Establishment Flows 

Figure 114 on page 582 through Figure 128 on page 595 show the flow of requests 
and responses between the sscp and logical and physical units to establish ses¬ 
sions. 

« Requests initiated by primary logical units (plus) (Figure 114 on page 582 
through Figure 117 on page 585) 

• An independent PLU-initiated request for lu-lu session establishment 
(Figure 118 on page 586) 
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• A PLU-initiated request for lu-lu session establishment with an independent slu 
(Figure 119 on page 587) 

• SLU-initiated requests (Figure 120 on page 588 through Figure 123 on 
page 590) 

• An independent SLU-initiated request for lu-lu session establishment with a plu 
(Figure 124 on page 591) 

• Third party-initiated requests (Figure 125 on page 592 and Figure 126 on 
page 593) 

• VARY LOGON or logappl processing (Figure 127 on page 594) 

• Notification of plu Availability (Figure 128 on page 595) 


Deactivation and Termination Flows 

Figure 129 on page 596 through Figure 138 on page 604 show the flow of requests 
and responses between the sscp and logical and physical units to deactivate 
resources and end sessions. 

• Deactivating a logical unit (Figure 129 on page 596 and Figure 130 on 
page 596) 

• Deactivating a logical unit with giveback (Figure 131 on page 597) 

• vary term processing (Figure 132 on page 598 and Figure 133 on page 599) 

• close acb processing (Figure 134 on page 600) 

• Deactivating an application program (Figure 135 on page 601) 

• Deactivating a cdrm (Figure 136 on page 602 through Figure 138 on page 604) 


ERP and Management Services Flows 

Figure 139 on page 605 through Figure 141 on page 606 show the flow of requests 
and responses between the sscp and logical and physical units to handle error 
recovery processing (erp) and route Forward and Deliver rus. 

• erp processing (Figure 139 on page 605 and Figure 140 on page 606) 

• sscp management services processing (Figure 141 on page 606) 
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mvs vm Cross-Network Flows 

mvs vm Activation Flows 

Figure 142 on page 607 through Figure 144 on page 609 show the flow of requests 
and responses activating a cross-network sscp-sscp session. 

• Gateway sscp requests session (Figure 142 on page 607) 

• Non-gateway sscp requests a session (Figure 143 on page 608) 

• Back-to-back gateway ncps request a session (Figure 144 on page 609) 


mvs vm Session Establishment Flows 

Figure 145 on page 610 through Figure 164 on page 631 show the flow of 
requests and responses to establish a cross-network lu-lu session. 

• SLu-initiated request for single gateway sscp and single gateway ncp 
(Figure 145 on page 610) 

• PLU-initiated request for single gateway sscp and single gateway ncp 
(Figure 147 on page 612) 

• Independent PLU-initiated request for single gateway sscp and single gateway 
ncp (Figure 149 on page 614) 

• PLU-initiated request setup queued for single gateway sscp and single gateway 
ncp (Figure 150 on page 615) 

• SLu-initiated request for a single gateway connecting three or more networks 
(Figure 152 on page 617) 

• Default partitioning of gateway sscp responsibility spanning three networks 
(Figure 153 on page 618) 

• SLU-initiated request for predesignated control of gateway ncp by middle host 
(Figure 154 on page 619) 

• Multiple gateway sscps and back-to-back gateway ncps (Figure 156 on 
page 623) 

• Third-party-initiated request spanning three networks (Figure 157 on 
page 624) 

• Initiate with vary logon or Controlling plu for single gateway sscp and single 
gateway ncp (Figure 158 on page 625) 

• SLU-initiated session initiation failure (cdinit rejection) for single gateway sscp 
and single gateway ncp (Figure 160 on page 627) 

• SLU-initiated session initiation failure (setcv failure) for single gateway sscp 
and single gateway ncp (Figure 162 on page 629) 

• SLU-initiated setup procedure failure (cinit rejection) for single gateway sscp 
and single gateway ncp (Figure 164 on page 631) 
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MVS VM Deactivation and Termination Flows 

Figure 166 on page 633 through Figure 178 on page 644 show the flow of requests 
and responses to deactivate resources and end sessions. 

• plu sends unbind for single gateway sscp and single gateway ncp (Figure 166 
on page 633) 

• Independent plu sends unbind for independent slu (Figure 167 on page 633) 

• Independent plu sends cleanup for independent slu (Figure 168 on page 634) 

• slu requests Terminate Self for single gateway sscp and single gateway ncp 
(Figure 169 on page 635) 

• slu requests Terminate Self (Cleanup Option) for single gateway sscp and 
single gateway ncp (Figure 170 on page 636) 

• plu sends unbind for multiple gateway sscps and a single gateway ncp 
(Figure 172 on page 638) 

• slu requests Terminate Self for multiple gateway sscps and back-to-back 
gateway ncps (Figure 173 on page 639) 

• Terminating an sscp-sscp session (Figure 174 on page 640) 

• Terminating an lu-lu session between two independent lus (Figure 175 on 
page 641) 

• Route failure causes session termination (Figure 176 on page 642) 

• Route failure causes session termination for multiple gateway sscps and back- 
to-back gateway ncps (Figure 178 on page 644) 
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Communication 

$$CP PUS Controller PU 



Figure 94. Session Activation: ACTPU. 


* The ACTPU may flow either to the communication controller or to a physical 
unit. 


Communication 

SSCP PUS Controller PU LU 



Figure 95. Session Activation: ACTLU 
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Figure 96. Session Activation: BIND 


Operator's Communication 
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Figure 97. Activating a Virtual Route and the Associated Explicit Route 
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Figure 96. Activating a Channel-Attached Communication Controller. 

1 Includes NCR Dynamic Path Definition capability indicator in V3R2. 

2 Flows only for Dynamic Path Definition in V3R2. 

SETCV and IST929I flow for each Dynamic Path Definition Member specified. 
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Figure 99. Activating a Link-Attached Communication Controller. 

1 Includes NCP Dynamic Path Definition capability indicator in V3R2. 

2 Flows only for Dynamic Path Definition in V3R2. 

SETCV and IST929I flow for each Dynamic Path Definition Member specified. 
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Figure 100. Activating a Link (ACTLINK) 
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Figure 101. Activating a Switched Link with Takeover. 

1 SETCV does not flow for NCPs that support peripheral nodes. 
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Figure 102. Activating a Cross-Subarea Link Station 
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Figure 103. Establishing Contact with a Channel-Attached Host 
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Figure 104. Establishing a Switched Connection. To establish a switched connection, the 
SSCP sends an Active Link request to indicate that the link is active. An 
Active Connect In request is sent to enable the communication controller to 
answer incoming calls. (Instead of Activate Connect In, Dial could be sent to 
initiate an outbound call.) When a call comes in, the communication con¬ 
troller sends an XID (exchange identification) and the physical unit responds 
with its ID (station address). The communication controller sends a Request 
Contact (Offhook) request to the SSCP. The SSCP sends a Set Control Vector 
request containing address and pacing information to the communication con¬ 
troller. The standard activation sequence then occurs (see Figure 99 on 
page 569). 
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Figure 105. Activating a Type 2 Physical Unit 

Note: If the physical unit must be loaded, additional rus will flow. See Figure 106 
for more information. 
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Figure 106. Activating a Type 2 Physical Unit with Load Required 
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This figure shows only the rus that flow when a type 2 physical unit requires 
loading. For the rus that flow before and after those in this figure, see Figure 105. 

Some devices, such as the ibm 8775, may require loading. During activation of the 
physical unit, the request for load is indicated in the actpu response. (Following 
activation, the physical unit may request loading with an ns.ldreqd ru.) 

The sscp formats the load request into a network services (ns) ru to initiate the 
load. The management services subcomponent of the sscp then sends the 
embedded request to the physical unit load program of the Downstream Load 
Utility. 

If the physical unit load program is not available, it sends a negative response to 
the sscp's Deliver ru. The sscp then sends an ns_ipl_abort ru to the physical unit 
for deactivation processing. (If the load was requested with an ns_ldreqd ru, the 
physical unit is not deactivated; in fact, it may try the load request again.) 

If the physical unit load program is available, it sends a positive response to the 
sscp's Deliver ru. The load program then sends a forward ru, containing an 
ns_loadstat ru, to relay the status of the load operation. 
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Figure 107. Moving a SYSGENned Physical Unit. 


1 RNAA flow is as normal. RNAA does not flow for MODIFY DR, 
TYPE = MOVE, ACT= NO. 
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Figure 108. Moving a Dynamically Added Physical Unit. 

1 RNAA flow is as normal. RNAA does not flow for MODIFY DR, 
TYPE = MOVE, ACT = NO. 
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Figure 109. SSCP Takeover of Peripheral Node Logical Units. 

1 Independent logical unit only. 

2 Dependent logical unit only. 

Note: The following conditions are assumed for this example: 

• The physical units being taken over are defined with ans=continue, specifying 
that any lu-lu sessions that are active at sscp-takeover time will continue. 

• There are some lu-lu sessions active at failure time under the physical unit 
being taken over. 
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Figure 110. Activating a Logical Unit 
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Figure 111. Activating an Application Program/Processing an OPEN ACB Request. 

1 These do not flow for OPEN ACB processing. 

2 PUNS cannot send a response to the OPEN ACB request until LUS receives an ACTLU request for the 
. application program. Therefore, PUNS issues CPWAIT and waits for LUS to post it. Once LUS has 

received the ACTLU, it posts PUNS, which then sends a response io the OPEN ACB request. 
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Figure 112. Activate CDRM with ERP Response 
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Figure 113. Activate CDRM with COLD Response 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Appendix C. Network Flows 581 













“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 



Figure 115. Primary Logical Unit Initiate (SIMLOGON). 


* LOGON EXIT and OPNDST ACC flow only when the PLU is associated with an application program. It 
does not appear in the flow if the PLU is a device-type logical unit. This is true for many following flows 
with LOGON EXIT and OPNDST ACC. 
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Figure 116. Primary Logical Unit Initiate (SIMLOGON(RELREQ)) 
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* If the session is pending active, the NOTIFY request and the RELREQ EXIT request flow after the 
response to the CDINIT request from PLU2 / s SSCP. If the session is already in progress, these requests 
flow after the response to the OPNDST ACC. 
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Figure 118. Independent PLU-lnitiated Cross-Domain Session Initiation with Independent 
SLU. 

* RNAA flows only if the network address is needed. 
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Figure 119. PLU-lnitiated Cross-Domain Session Initiation with Independent SLU. 
* RNAA flows only if the network address is needed. 
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Figure 120. Secondary Logical Unit Initiate (LOGON) 
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Figure 121. Secondary Logical Unit Initiate (REQSESS) 
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Figure 122. Secondary Logical Unit Initiate (INIT SELF) 



In this example, the logical unit sends a character-coded logon or logoff to the 
sscp. The unformatted system services portion of sscp converts the logon into a 
field-formatted Initiate Self or Terminate Self request. The request is then passed 
to the sscp request processor. 


If the return code indicates an unsuccessful transmission, the unformatted system 
services portion of sscp converts the request into a form that can be understood by 
the terminal logical unit. 
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Figure 124. Dependent SLU-lnitiated Cross-Domain Session Initiation with Application LU 
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Figure 125. Third Party Initiate (CLSDST PASS). 


1 V3R2 only 
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Figure 126. Third Party Initiate (CLSDST PASS with NOTIFY) 
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* This applies only when the PLU is associated with an application program. It does not appear in the 
flow if the PLU is a device-type logical unit. 
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Figure 129. Deactivating a Logical Unit (Immediate). 

* These flow only when the operator activates a specific logical unit. For example, they do not flow 
during immediate deactivation of a CDRM. 
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Figure 130. Deactivating a Logical Unit (Forced). 

* These flow only when the operator deactivates a specific logical unit. For example, they do not flow 
during forced deactivation of a CDRM. 
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Figure 131. Deactivating a Logical Unit with Giveback. 

1 The DACTLINK X‘02' disconnects only queued and pending LU-LU sessions. 
Active LU-LU sessions remain active. 

2 After session services transfers SIBs of ACTIVE logical units to the CDRSC, 
configuration services SRT ADDs the CDRSCs as real resources, and the 
logical units are ADDed as shadow resources. If a CDRSC for a particular 
logical unit does not exist, a dynamic CDRSC is allocated for the logical unit. 
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Figure 132. VARY NET,TERM Unconditional 
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Figure 133. VARY NET,TERM Cleanup 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 


Appendix C. Network Flows 599 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


Configuration Session 

EU OPEN/CLOSE LUS PUS Services TSC Services 



1 The repetition of flows shown here indicates multiple sessions. 

2 PUNS cannot send a response to the CLOSE ACB AMRU until DACTLU processing is complete and the 
LUCB and FMCB for the application program have been deleted. Therefore, after requesting that config¬ 
uration services deactivate the logical unit, PUNS issues CPWAIT and waits for LUS to post it when the 
logical unit has been deactivated. Once it is posted, PUNS waits to be notified that there are no more 
active sessions for the application program. It issues CPWAIT (1) and waits for configuration services to 
send a request to delete the FMCB. PUNS posts itself when it has processed each of these requests and 
sends a response to configuration services to notify it that the LUCB has been deleted. After sending 
this response, PUNS sends a response to the CLOSE ACB AMRU. 
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Figure 135. Deactivating an Application Program. 


* PUNS cannot send a response to the CLOSE ACB AMRU until there are no more active sessions for the 
application program. Therefore, after the SSCP sends a request to delete the FMCB, PUNS issues 
CPWAIT (1) and waits for OPEN/CLOSE to send it a CLOSE ACB AMRU. Once it has received this 
request, PUNS issues CPWAIT (2) and waits for TSC to send a request to delete the LUCB. PUNS posts 
itself when it has deleted the FMCB and sends a response to configuration services, then posts itself 
when it has deleted the LUCB. After posting itself the second time, PUNS sends a response to the 
CLOSE ACB AMRU. 
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Figure 136. Deactivating a CDRM - Normal. 

* Session services purges the queues of user session requests. Since this 
processing is internal to session services, no RUs flow between components. 

Note: When the CDRM is actually deactivated, immediate processing takes 
place. See Figure 137 on page 603 for the RUs that flow for immediate deac¬ 
tivation of a CDRM. 
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Figure 137. Deactivating a CDRM - Immediate. 


* See Figure 129 on page 596 for deactivate immediate processing for a 
logical unit. 
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Figure 138. Deactivating a CDRM - Forced. 


* See Figure 130 on page 596 for deactivate (force) processing for a logical 
unit. 


604 VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 




SSCP 

SSCP 



Operator's 

Session 

Configuration 

LU 

Network 

Console 

Services 

• 

Services 

i 

Services 


INOP (STATION) "SOFT" 


CONTACT 

PU_T2 


H 


ERP in Progress 


TERMINATE 

CLEANUP 


+ RESP 




K 


< - 

NOTIFY 8 


CLEANUP 


RESP 


SESSEND 8 


CLEANUP 


NSEXIT 

or 

LOSTERM 


CLSDST a 



Figure 139. Error Recovery Processing - Soft INOP. 

1 If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends a positive response to the 
cleanup request. If the LOSTERM exit routine is scheduled, LUS does not clean up the session, and it 
sends a negative response to the cleanup request. 

2 These flow only if the LOSTERM exit routine is scheduled. 
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Figure 140. Error Recovery Processing - Hard INOP. 

1 If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends a positive response to the 
cleanup request. If the LOSTERM exit routine is scheduled, LUS does not clean up the session, and it 
sends a negative response to the cleanup request. 

2 These flow only if the LOSTERM exit routine is scheduled. 
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Figure 141. FORWARD and DELIVER Routing. 

1 RUx is a maintenance service RU. 

2 Either RUy contains data in reply to RUx, or it is an unsolicited RU. 
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Figure 142. mvs vm Activating a Cross-Network SSCP-SSCP Session: GWSSCP Requests 
Session 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Appendix C. Network Flows 607 



“Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


Operator's 

Console 


SSCP2 
Network B 


GatewayNCP 
for Network A 
and Network B 


Gateway 
SSCP1 
Network A 


VNET,ACT,ID~ SSCP1 

Message IST0971. 
Command Accepted 


Message IST4751, 
Procedure Failed 


ACTCDRM(vector) 


REQACTCDRM 


RNAA (for SSCPIof 
and SSCP2) _ 

+ RESP (address of 
SSCP1 and SSCP2) 

SETCV (address map, 
VRID lists) _ 


ACTCDRM (vector) 


NOTIFY (SESSST) 


Figure 143. mvs vm Activating a Cross-Network SSCP-SSCP Session: Non-GWSSCP 
Requests Session 
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Figure 144. mvs vm Activating a Cross-Network SSCP-SSCP Session: Back-to-Back GWNCPs Request Sessions 
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Figure 145. MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Single GWSSCP and 
Single GWNCP (Pre-V3R2) 
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Figure 146. mvs VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Single GWSSCP and 
Single GWNCP (V3R2) 
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Figure 147. MVS vm Establishing a Cross-Network LU-LU Session: PLU-lnitiated Request for Single GWSSCP and 
Single GWNCP (Pre-V3R2). 

Note: Session setup continues as in the flow for an SLU-initiated session. 
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Figure 148. MVS VM Establishing a Cross-Network LU-LU Session: PLU-lnitiated Request for Single GWSSCP and 
Single GWNCP (V3R2). 

Note: Session setup continues as in the flow for an SLU-initiated session. 
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Figure 149. MVS vm Establishing a Cross-Network LU-LU Session: Independent PLU Request for Single GWNCP with 
an Independent SLU. 

* RNAA flows only if the network address is needed. 
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Figure 150. MVS vm Establishing a Cross-Network LU-LU Session: PLU-lnitiated Request Setup Queued for Single 
GWSSCP/Single GWNCP (Pre-V3R2). 

Note: Session setup continues as in the flow for an SLU-initiated session. 

* Names only sent conditionally. 
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Figure 151. MVS vm Establishing a Cross-Network LU-LU Session: PLU-lnitiated Request Setup Queued for Single 
GWSSCP/Single GWNCP (V3R2). 

Note: Session setup continues as in the flow for an SLU-initiated session. 

* Names only sent conditionally. 
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Figure 152. mvs vm Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Single Gateway Con¬ 
necting Three or More Networks 
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Figure 153. mvs vm Establishing a Cross-Network LU-LU Session: Default Partitioning of GWSSCP Responsibility 
Spanning Three Networks. 

Note 1: Only the SSCP-SSCP session communication is shown. Assume LU1 (a logical unit owned by 
SSCP1 in Network A) requests a session with DLUX (an alias for LU3 in Network B; LU3 is a logical unit 
owned by gateway SSCP3). LU1 is the SLU in the request session. 

Note 2: Session setup proceeds as shown in the basic flows. BIND flows from LU3 to gateway NCP2, to 
gateway NCP1, and to LU1. 
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Figure 154 (Part 1 of 2). 


MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Predesig 
nated Control of GWNCP by Middle Host (Pre-V3R2) 
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Figure 154 (Part 2 of 2). MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Predesig¬ 
nated Control of GWNCP by Middle Host (Pre-V3R2) 
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Figure 155 (Part 1 of 2). 


MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Predesig¬ 
nated Control of GWNCP by Middle Host (V3R2) 
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Figure 155 (Part 2 of 2). 


mvs vm Establishing a Cross-Network LU-LU Session: SLU-lnitiated Request for Predesig¬ 
nated Control of GWNCP by Middle Host (V3R2) 
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Figure 156. MVS VM Establishing a Cross-Network LU-LU Session: Multiple GWSSCPs and Back-to-Back GWNCPs 
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Figure 157. MVS VMEstablishing a Cross-Network LU-LU Session: Third Party-Initiated Request Spanning Three Net¬ 
works 
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Figure 158. mvs VMEstablishing a Cross-Network LU-LU Session: Initiate with VARY LOGON or Controlling PLU for 
Single GWSSCP/Single GWNCP (Pre-V3R2). 

Note 1: Assume LU1 is active. 

Note 2: Session setup continues as shown in the basic flows. 
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See Note 2 


Figure 159. MVS vm Establishing a Cross-Network LU-LU Session: Initiate with VARY LOGON or Controlling PLU for 
Single GWSSCP/Single GWNCP (Pre-V3R2). 

Note 1: Assume LU1 is active. 

Note 2: Session setup proceeds as shown in the basic flows. 
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Figure 160. mvs VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Session Initiation Failure (CDINIT 
Rejection) for Single GWNCP (Pre-V3R2) 
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Gateway NCP 

LU1 Gateway for Network A LU2 

(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 



Figure 161. MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Session Initiation Failure (CDINIT 
Rejection) for Single GWNCP (V3R2) 
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Figure 162. MVS vm Establishing a Cross-Network LU-LU Session: SLU-lnitiated Session Initiation Failure (SETCV) 
for Single GWSSCP/Single GWNCP (Pre-V3R2) 
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Figure 163. mvs vm Establishing a Cross-Network LU-LU Session: SLU-lnitiated Session Initiation Failure (SETCV) 
for Single GWSSCP/Single GWNCP (V3R2) 
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Figure 164. MVS vm Establishing a Cross-Network LU-LU Session: SLU-lnitiated Setup Procedure Failure (CINIT 
Rejection) for Single GWSSCP/GWNCP (Pre-V3R2) 
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Figure 165. MVS VM Establishing a Cross-Network LU-LU Session: SLU-lnitiated Setup Procedure Failure (CINIT 
Rejection) for Single GWSSCP/GWNCP (V3R2) 
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Figure 168. MVS vm Deactivating Resources and Ending Sessions: Independent PLU sends BFCLEANUP for Cross¬ 
domain LU-LU session. 

1 BFCLEANUP may be sent by the SSCP(PLU) for several reasons, including: 

A network operator at the SSCP(PLU) may issue a VARY NET,TERM,UNCOND, generating an 
internal TERM-OTHER(forced). 

A network operator at either SSCP may issue a VARY NET,INACT,ID = cdrm, deactivating all cross¬ 
domain sessions between the SSCPs. 
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Figure 169. MVS vm Deactivating Resources and Ending Sessions: SLU Requests Terminate Self for Single GWSSCP 
and Single GWNCP 
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Figure 170. MVS VMDeactivating Resources and Ending Sessions: SLU Requests Terminate Self (Cleanup Option) 
for Single GWSSCP/GWNCP (Pre-V3R2) 
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Figure 171. MVS VMDeactivating Resources and Ending Sessions: SLU Requests Terminate Self (Cleanup Option) 
for Single GWSSCP/GWNCP (V3R2) 
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Figure 173. MVS VM Deactivating Resources and Ending Sessions: SLU Requests Terminate Self for Multiple 
GWSSCPs and Back-to-Back GWNCPs 
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N°t e: An outage occurs on the route in Network C used by the LU1-LU2 session. ERUNOP reports the 
failure to gateway NCP1 and gateway NCP2. 


Figure 174. mvs vm Deactivating Resources and Ending Sessions: Terminating an SSCP-SSCP Session 
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Figure 175. mvs vm Deactivating Resources and Ending Sessions: Active Session Termination of T2.1 Nodes 
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Figure 176. MVS VM Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination 
(Pre-V3R2). Note 1: A cross-network LU-LU session exists between LU3 and LU2. 

1 See Figure 166 on page 633 through Figure 178 on page 644 for details of CDSESSEND processing. 

2 This flow assumes that the gateway SSCP1 established the network address translation for the 
gateway SSCPI-to-gateway SSCP2 session with the RNAA RU. The NOTIFY to free the transform is sent 
only if the RNAA that established the address specified “retain address.” 
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Figure 177. MVS VM Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination 
(V3R2). Note 1: A cross-network LU-LU session exists between LU3 and LU2. 

1 See Figure 166 on page 633 through Figure 178 on page 644 for details of CDSESSEND processing. 

1 This flow assumes that the gateway SSCP1 established the network address translation for the 
gateway SSCPI-to-gateway SSCP2 session with the RNAA RU. The NOTIFY to free the transform is sent 
only if the RNAA that established the address specified “retain address.” 
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Figure 178. MVS vm Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination for 
Multiple GWSSCPs and Back-to-Back GWNCPs. 

Note 1: An outage occurs on route in Network C used by the gateway SSCPI-to-gateway SSCP2 session. 
The failure is reported to gateway NCP1 and gateway NCP2 with an ER INOP RU. 

1 The NOTIFY to free the transform is sent only if the RNAA that established the address specified 
"retain address." 


644 


VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 



“Restricted Materials of IBM” 

Licensed Materials - Property of IBM 


Appendix D. CPCB Operation Codes 

Many vtam processes are represented by rupe. ncspl, dlrpl, cpcb, ppl, or tqe work 
elements. Each of these work elements contains a prefix called a cpcb at the 
beginning of the control block. The cpcb prefix contains a field called the cpcb 
operation code (cpcbopc), which provides an exact indication of the type of vtam 
process represented by the work element. 

The cpcbopc field is located at a displacement of hex 10 (decimal 16) from the 
beginning of each of the above-named control blocks. The cpcbopc field is 4 bytes 
long and contains a category byte (cpcbcat), followed by a 3-byte specific opera¬ 
tion code field (cpcbfmh). 

The possible contents of the cpcb operation code category are summarized below: 


Category (hex) 

Meaning 

00 

Operator command 

01 

Dump/load/restart request 

02 

I/O purge request 

03 

Timer management request 

04 

Unformatted RU 

08 

Function management data RU 

09 

Network control RU 

0A 

Data flow control RU 

0B 

Session control RU 

OC 

Function management data access method RU 

0D 

Network control access method RU 

0E 

Data flow control access method RU 

OF 

Session control access method RU 


The following table summarizes the possible values of the cpcb operation code 
field. For each value, the character string representation which may appear in 
vtam operator messages is given, along with the function of the associated work 
element. 
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CPCBOPC 

Message 

Function 

00010000 

VARY 

VARY Command 

00010001 

VARY ACT 

VARY Activate 

00010002 

VARY INACT 

VARY Deactivate 

00010004 

VARY LOGON 

VARY LOGON 

00010005 

VARY ACT 

VARY Activate, 

LOGON Parameter Specified 

00010008 

VARY DRDS 

VARY DRDS 

00010012 

VARY INACT 

VARY Deactivate Immediate 

00010032 

VARY INACT 

VARY Deactivate Immediate (Internal) 

00010040 

VARY ANS 

VARY ANS 

00010041 

VARY ACT 

VARY Activate, 

ANS Parameter Specified 

00010045 

VARY ACT 

VARY Activate, 

ANS and LOGON Parameters Specified 

00010100 

VARY PATH 

VARY PATH =» USE 

00010200 

VARY PATH 

VARY PATH = NOUSE 

00010400 

VARY INOP 

VARY INOP 

00010802 

FORCE DEAC 

Force Deactivate 

00011002 

FORCE REAC 

Force Reactivate 

00011802 

VARY INACT 

VARY Deactivate Giveback 

00012000 

VARY ACQ 

VARY Acquire 

00012001 

VARY ACQ 

VARY Activate, 

ACQ Parameter Specified 

00012002 

INACT SON 

Deactivate (Session Outage Notification) 

00012005 

VARY ACQ 

VARY Activate, 

ACQ and LOGON Parameters Specified 

00014000 

VARY REL 

VARY Release 

00014010 

VARY REL 

VARY Release Immediate 

00018004 

VARY NOLOGON 

VARY NOLOGON 

00020001 

F DUMP 

MODIFY DUMP 

00020002 

FENCR 

MODIFY ENCR 

00020004 

F CHANGE 

MODIFY CHANGE 
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CPCBOPC 

Message 

Function 

000200A0 

F TRACE 

MODIFY TRACE, NETCNTR 

00020000 

F NOTRACE 

MODIFY NOTRACE, NETCNTR 

00020010 

F TABLE 

MODIFY TABLE 

00020120 

F AGPTRACE 

MODIFY Activate generalized PIU trace 

00020140 

F DGPTRACE 

MODIFY Deactivate generalized PIU trace 

00020180 

F LOAD ADD 

MODIFY LOAD ADD 

00020200 

FCDRM 

MODIFY CDRM 

00020280 

F LOAD REP 

MODIFY LOAD REPLACE 

00020401 

TRANSFER NCP 
DUMP 

Transfer DUMP (NCP) 

00020408 

F DR MOVE 

MODIFY DR MOVE 

00020480 

F LOAD PRG 

MODIFY LOAD PURGE 

00020301 

PRG NCP DUMP 

PURGE DUMP (NCP) 

00020808 

F DR DELETE 

MODIFY DR DELETE 

00020820 

F ALTRACE 

MODIFY Activate Line Trace 

00020840 

F DLTRACE 

MODIFY Deactivate Line Trace 

00020880 

F LOAD CNC 

MODIFY LOAD CANCEL 

00021001 

F DUMP CSP 

MODIFY DUMP (CSP) 

00021801 

PRG DUMP CSP 

PURGE DUMP (CSP) 

00022001 

F DUMP MOS 

MODIFY DUMP (MOSS) 

00022801 

PRG DUMP MOS 

PURGE DUMP (MOSS) 

00024001 

F DUMP DYN 

MODIFY Dump (Dynamic) 

00024020 

F ACT SIT 

MODIFY Activate SIT Trace 

00024040 

F DACT SIT 

MODIFY Deactivate SIT Trace 

00028001 

F DUMP DYN CH 

MODIFY Dump (Dynamic-CH) 

00028820 

F ATGTRACE 

MODIFY Activate TG Trace 

00028840 

F DTGTRACE 

MODIFY Deactivate TG Trace 

00030001 

SOFT INOP 

SOFT INOP 

00030002 

SSCP TKOVR 

SSCP TAKEOVER 

00030004 

HARD INOP 

HARD INOP 

00040000 

DISP INT 

Display Internal Commands 
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CPCBOPC 

Message 

Function 

00060001 

INT SYNCH 

Internal Synchronization Function 

00060002 

IPL INIT 

‘ IPL Initial Request 

00060004 

IPL TEXT 

IPL Text Request 

00060008 

IPL FINAL 

IPL Final Request 

00060010 

DUMP INIT 

Dump Initial Request 

00060020 

DUMP TEXT 

Dump Text Request 

00060040 

DUMP FINAL 

Dump Final Request 

00060100 

HALT CDLNK 

Process Cross-Domain Links During HALT 

00061001 

REQDMP CSP 

Request CSP Dump 

00062000 

RESET LU 

Reset LU 

00062001 

REQDMP MOS 

Request MOSS Dump 

00063001 

INT TRF DH 

Internal transfer of dump header 

00063002 

INT TRF DMS 

Internal transfer of dump main storage 

00064000 

REQLOAD 

Request Load 

00064001 

REQDUMP DY 

Request Dynamic Dump Data 

00068000 

REQDUMP 

Request Dump 

00080001 

DIAL START 

Dial Start Request 

012B0000 

CKPTN 

Checkpoint Node Status Function 

014B0000 

CHKPT 

Checkpoint Resource Status Function 

OIBDOOOO 

CPMSG 

Internal WTOR Function 

01DD0000 

DLR PURGE 

Dump/Load/Restart Purge 

01EAOOOO 

CPCRYPT 

Cryptography Management Function 

01ED0000 

SELECT VR 

Virtual Route Select 

02510000 

CDRM CLEAR 

Clear CDRM-CDRM Session 

02520000 

CDRMERP 

CDRM ERP Internal Clear 

03000000 

TIMER REQ 

Set Timer Request 

04000000 

CHAR CODED 

Unformatted Request Unit 

08010001 

CHG TLIMIT 

Change Transmission Limit 

08010002 

CHG NRSPOL 

Change Negative Response to Poll Limit 

08010003 

CHG SESSLM 

Change Session Limit 

08010004 

CHG POLLIM 

Change Poll Limit 
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CPCBOPC 

Message 

Function 

08010201 

CONTACT 

Contact 

08010202 

DISCONTACT 

Discontact 

08010203 

IPL INIT 

NC IPL Initial 

08010204 

IPL TEXT 

NC IPL Text 

08010205 

IPL FINAL 

NC IPL Final 

08010206 

DUMP INIT 

Dump Initial 

08010207 

DUMP TEXT 

Dump Text 

08010208 

DUMP FINAL 

Dump Final 

08010209 

RMPO 

Remote Power Olf 

0801020A 

ACTLINK 

Activate Link 

0801020B 

DACTLINK 

Deactivate Link 

0801020E 

CONNOUT 

Connect Out 

0801020F 

ABCONN 

Abandon Connection 

08010211 

SCV 

Set Control Vector 

08010214 

ENT SLOWDN 

Enter Slowdown 

08010215 

EXT SLOWDN 

Exit Slowdown 

08010216 

ACTCONNIN 

Activate Connect In 

08010217 

DACTCONNIN 

Deactivate Connect In 

08010218 

ABCONNOUT 

Abandon Connect Out 

08010219 

ANA 

Assign Network Address 

0801021A 

FNA 

Free Network Address 

0801021B 

REQDISCONT 

Request Discontact 

08010280 

CONTACTED 

Contacted 

08010281 

INOP 

Inoperative 

08010284 

REQCONT 

Request Contact 

08010285 

NSLSA 

Network Services Lost Subarea 

08010302 

ACTTRACE 

Activate Trace 

08010303 

DACTTRACE 

Deactivate Trace 

08010331 

DISP STOR 

Display Storage 

08010334 

RECSTOR 

Record Storage 

08010381 

RECMS 

Record Maintenance Statistics 
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CPCBOPC 

Message 

Function 

08010382 

REC TEST 

Record Test Data 

08010383 

REC TRACE 

Record Line Trace Data 

08010480 

RECMD 

Record Measurement Data 

08010604 

NSPE 

Network Services Procedure Error 

08010681 

INIT SELF 

Initiate(Self) Format 0 

08010683 

TERM SELF 

Terminate(Self) Format 0 

083F0233 

INIT LOAD 

NS Init Load 

083F0234 

LOAD STAT 

NS Load Status 

083F0814 

TR-INQUIRY 

Translate Inquiry 

083F0816 

TR-REPLY 

Translate Reply 

08410210 

RNAA 

Request Network Address Assignment 

08410220 

NFY SESSEND 

Notify Sessend 

08410237 

LOAD REQRD 

NS Load Required 

08410240 

ADDNR 

Add Network Resource 

08410243 

IPL INIT 

NS IPL Init 

08410244 

IPL TEXT 

NS IPL Text 

08410245 

IPL FINAL 

NS IPL Final 

08410246 

IPL ABORT 

NS IPL Abort 

08410286 

RDELETENR 

Request Delete Network Resource 

08410287 

LOST CTLPT 

Lost Control Point 

08410289 

ROUTE-INOP 

Network Services Route Inoperative 

0841028A 

REQACTCDRM 

Request ACTCDRM 

08410304 

REQ MNT ST 

Request Maintenance Statistics 

08410305 

LINKLVL2 

Enter Test Mode (LL2) 

08410307 

REQ RTTEST 

Request Route Test 

08410311 

MS SCV 

Maintenance Services Set Control Vector 

08410384 

RECFMS 

Record Formatted Maintenance Statistics 

08410385 

RECTR 

Record Test Results 

08410386 

ER TESTED 

Explicit Route Tested 

08810387 

REQ ECHO 

Request Echo Test 

08810389 

ECHO TEST 

Echo Test 
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CPCBOPC 

Message 

Function 

08810601 

CINIT 

Control Initiate 

08810602 

CTERM 

Control Terminate 

08810620 

NOTIFY 

Notify 

08810629 

CLEANUP 

Cleanup 

08810680 

INIT OTHER 

Initiate(Other) 

08810681 

INIT SELF 

Initiate(Self) Format 1 

08810682 

TERM OTHER 

Terminate(Other) 

08810683 

TERM SELF 

Terminate(Self) 

08810685 

BIND FAIL 

Bind Failure 

08810686 

SESS START 

Session Started 

08810687 

UBIND FAIL 

Unbind Failure 

08810688 

SESS ENDED 

Session Ended 

08810810 

FORWARD 

Forward Request 

08810812 

DELIVER 

Deliver Request 

08810814 

CNM REQ 

CNM Request 

08812601 

BF CNTL INIT 

BF Control Initiate 

08812629 

BF CLEANUP 

BF Cleanup 

08812681 

BF INIT 

BF Initiate 

08812683 

BF TERM 

BF Terminate 

08812686 

BF SESS STRT 

BF Session Start 

08812688 

BF SESS END 

BF Session End 

0881268C 

BF SESS INFO 

BF Session Information Request 

08818620 

CD NOTIFY 

Cross-Domain Notify 

08818627 

CD DSEARCH 

Cross-Domain Direct Search List 

08818640 

CDINIT OTH 

Cross-Domain Initiate (Other) 

08818641 

CDINIT 

Cross-Domain Initiate 

08818643 

CDTERM 

Cross-Domain Terminate 

08818645 

CDSSF 

Cross-Domain Session Setup Failure 

08818646 

CDSESSST 

Cross-Domain Session Started 

08818647 

CDSTF 

Cross-Domain Session Takedown Failure 

08818648 

CDSESSEND 

Cross-Domain Session Ended 
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CPCBOPC 

Message 

Function 

08818649 

CDTAKEDOWN 

Cross-Domain Takedown 

0881864A 

CDTD COMP 

Cross-Domain Takedown Complete 

0881864B 

CDCINIT 

Cross-Domain Control Initiate 

09050000 

NCLSA 

Network Control Lost Subarea 

09060000 

ER INOP 

Explicit Route Inoperative 

09070000 

ANSC 

Auto Network Shutdown Complete 

09080000 

LOST PATH 

Lost Path 

09090000 

ER TEST 

Explicit Route Test 

09OAOOOO 

ER TST RPY 

Explicit Route Test Reply 

09OBOOOO 

ER ACT 

Explicit Route Activate 

090C0000 

ER ACT RPY 

Explicit Route Activate Reply 

090D0000 

ACTVR 

Activate Virtual Route 

090E0000 

DACTVR 

Deactivate Virtual Route 

090F0000 

ER OP 

Explicit Route Operative 

09510000 

SW TO NCP 

Switch Line to NCP Mode 

09520000 

SW TO EP 

Switch Line to EP Mode 

0A040000 

LUSTAT 

LU Status 

0A050000 

RTR 

Ready to Receive 

0A700000 

BIS 

Bracket Initiation Stopped 

0A710000 

SBI 

Stop Bracket Initiation 

0A800000 

QEC 

Quiesce at End of Chain 

0A810000 

QC 

Quiesce Complete 

0A820000 

RELQ 

Release Quiesce 

0A830000 

CANCEL 

Cancel 

0A840000 

CHASE 

Chase 

0AC00000 

SHUTDOWN 

Shutdown 

0AC10000 

SHUTC 

Shutdown Complete 

0AC20000 

RSHUTD 

Request Shutdown 

0AC80000 

BID 

Bid 

0AC90000 

SIGNAL 

Signal 

0B0D0000 

ACTLU 

Activate LU 
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CPCBOPC 

Message 

Function 

OBOEOOOO 

DACTLU 

Deactivate LU 

OBI10000 

ACTPU 

Activate PU 

OBI20000 

DACTPU 

Deactivate PU 

0B140000 

ACTCDRM 

Activate CDRM 

0B150000 

DACTCDRM 

Deactivate CDRM 

0B310000 

BIND 

Bind Session 

0B320000 

UNBIND 

Unbind Session 

0BA00000 

SDT 

Start Data Traffic 

OB A10000 

CLEAR 

Clear Session 

0BA20000 

STSN 

Set and Test Sequence Numbers 

OBA30000 

RQR 

Request Recovery 

0BC00000 

CRV 

Cryptography Verify 

0C0102A0 

AM ALLORSC 

Allocate Resource 

0C0102A1 

AM FREERSC 

Free Resource 

0C0102A2 

AM SETRT 

Set Routable State 

0C0102A3 

AM RESETRT 

Reset Routable State 

0C010480 

AM RCRD MS 

DATA 

Record Measurement Data 

0C410206 

AM GAINED GWN 

Gained GWN 

0C410207 

AM LOST GWN 

Lost GWN 

0C410208 

AM DACT TRF 

Deactivate Transforms 

0C410210 

AM RNAA 

Request Network Address Assignment 

0C410212 

AM CONN 

Connect 

0C410213 

AM DISC 

Disconnect 

0C410214 

AM INIT PU 

Initiate PU 

0C410266 

XID 

AM Exchange ID 

0C4102BD 

AM ADDLINK 

Add Link 

0C4102BE 

AM ADDLSTA 

Add Link Station 

OC4102BF 

DELETENR 

Delete Network Resource 

0C4102CD 

AM REQDUMP 

Request Dump 

0C4102CE 

AM CONDLOD 

Request Conditional Load 
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CPCBOPC 

Message 

Function 

0C4102CF 

AM UNCDLOD 

Request Unconditional Load 

0C410601 

AM OPNACB 

Open ACB 

0C410602 

AM CLSACB 

Close ACB 

0C810619 

AM ARCA 

Address Request Complete 

0C810620 

AM RESUME 

Resume 

0C810629 

AM CLEANUP 

Cleanup 

0C810643 

Generic TERM 

Termination Placeholder 

0C810680 

AM REALLOC 

Reallocate 

0C810681 

GEN SESS INIT 

Generic Session Initiation 

0C810801 

AM NOTIFY 

Notify 

0C810A00 

API SETLST 

SETLOGON(START) 

0C810A01 

API SETLSP 

SETLOGON(STOP) 

0C810A02 

API SETLQS 

SETLOGON(QUIESCE) 

OC810A10 

API SIMLOG 

SIMLOGON 

0C810A20 

API OPNACQ 

OPNDST(ACQUIRE) 

0C810A21 

API OPNACC 

OPNDST(ACCEPT) 

0C810A30 

API INQLOG 

INQUIRE(LOGONMSG) 

0C810A31 

API INQDVC 

INQUIRE(DEVCHAR) 

0C810A32 

API INQCNT 

INQUIRE(COUNTS) 

0C810A33 

API INQTOP 

INQUIRE(TOPLOGON) 

0C810A34 

API INQCID 

INQUIRE(CIDXLATE) 

0C810A35 

API INQTRM 

INQUIRE(TERMS) 

0C810A36 

API INQAPS 

INQUIRE(APPSTAT) 

0C810A37 

API INQSPM 

INQUIRE(SESSPARMS) 

0C810A38 

API INQSKY 

INQUIRE(SESSKEY) 

0C810A39 

API INQDSP 

INQUIRE(DISPLAY) 

0C810A40 

API INTERP 

INTRPRET 

0C810A50 

API CLSPAS 

CLSDST(PASS) 

0C810A51 

API CLSRLS 

CLSDST(RELEASE) 

0C810A60 

API SESONC 

SESSIONC 

0C810A70 

API SNDCMD 

SENDCMD 
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CPCBOPC 

Message 

Function 

0C810A75 

API SEND 

SEND 

0C810A80 

API RCVCMD 

RCVCMD 

0C810A85 

API RECEIVE 

RECEIVE 

0C810A90 

API REQSES 

REQSESS 

0C810AA0 

API OPNSEC 

OPNSEC 

0C810AB0 

API TRMSES 

TERMSESS 

0C810ACO 

API RESETSR 

RESETSR 

0D010000 

AM VR INOP 

Virtual Route Inoperative 

0D0B0000 

AM REQ ERA 

Request Explicit Route Activate 

0D0E0000 

AM REQ VRD 

Request Virtual Route Deactivate 

0DFF0000 

AM VR STAT 

Virtual Route Status 

0E010000 

AM PCE 

Purge Chain Element 

0F010000 

AM NFY SLT 

Notify (Schedule LOSTERM Exit) 

0F020000 

AM SSA 

Set Session Address 

0F030000 

AM SSADISC 

Set Session Address and Disconnect 

0F040000 

AM OSA 

Override Session Address 

0F050000 

AM PWQ 

Purge Wait Queue 

0F060000 

AM FLUSH 

Flush Virtual Route 

0F310000 

AM GBIND 

Generic BIND 

0F320000 

AM GUNBIND 

Generic UNBIND 

FF000000 

VECTOR 

VECTOR FMD request units 
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Appendix E. Storage and Control Block ID Codes 

This appendix lists the control block id codes for vtam and vscs control blocks. It 
also includes storage id codes for vscs. 

This appendix contains the following sections: 

• "VTAM Control Block ID Codes” on page 658 

• “vm VSCS Storage and Control Block Identifiers” on page 659. 
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VTAM Control Block ID Codes 

You can identify certain vtam control block types in a storage dump by examining 
an identification code in the first byte of the control block (offset 0). The control 
block identification codes are shown in the following table. In case of duplicate 
codes, use other means (such as the operating environment or the control block's 
context) to determine the type of control block. 


ID 

Control Block 

ID 

Control Block 

00 

RPL 

50 

DLRPL 

00 

SONCB 

52 

LUCB 

01 

RPH 

54 

RUPE 

03 

FMCB 

54 

TUNB 

05 

VRBLK 

57 

PPL 

06 

ICNCB 

58 

TQE 

07 

LDNCB 

5F 

CPCB 

09 

HALCB 

60 

NCSPL 

0A 

BSCLB 

61 

PST 

0B 

VLNCB (V3R1.2 and later) 

62 

LU 6.2 (V3R2) 

OC 

PCLCB (V3R1.2 and later) 

62 

NSICB, NSSCB 

0D 

PRWCB (V3R1.2 and later) 

63 

SMP 

0E 

TRGCB (V3R1.2 and later) 

65 

NACP 

OF 

ACDEB 

68 

RSQE 

10 

UECB 

69 

DTPL 

11 

DYPAB 

6B 

DSSIB (V3R2) 

13 

TRAC 

6C 

IOSIB (V3R2) 

14 

ERTE 

6D 

ASRIT 

18 

TIE 

6E 

GWIT 

19 

PDVT 

75 

WRE 

1A 

CHAIN 

77 

ADJSR 

IB 

TGCB 

81 

EXLST 

24 

OCW 

96 

SIBX 

25 

VCCB (V3R1.2 and later) 

97 

SIBIX (V3R2) 

26 

PICB (V3R1.2 and later) 

98 

SIB 

29 

LMPCB 

99 

TSCB 

2B 

RAQ 

9A 

PSPL (V3R1.2 and later) 

2C 

PAQ 

9A 

TSPL 

2D 

SAT 

A0 

ACB 

3B 

LICB (V3R1.2 and later) 

A2 

RNCA 

41 

PUSCB 

A3 

ALCA 

43 

PLSCB 

BF 

COS 

45 

POIA 

CO 

LOGMD 

46 

POCB 

CA 

GRPCB (V3R1.2 and later) 

47 

POMCB 

DO 

NIB 

48 

PORCB 

EB 

AUTOE 

49 

POWE 

FE 

XCNCB 

4A 

MALT 

FF 

OCA 

4C 

ERCT 

FF 

PLL (V3R1.2 and later) 

4D 

TGE 

$PIO 

PIO 

4E 

VRWSE 
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vm VSCS Storage and Control Block Identifiers 

You can identify certain vscs control block types in a storage dump by examining 
an identification code in the first byte of the control block. 


Storage Identifiers 


ID Storage Type 

SS Static storage 

SD Dynamic storage 

ZZ Dummy storage prefix 


Control Block Identifiers 


ID 

Control Block 

CG 

DTICGB 

Cl 

DTICIA 

CL 

DTICLB 

CM 

DTICMD 

DTICXWB 

DTISWBs for Communication Services 

DTIPSWB 

DTISWBs for Presentation Services 

DTISPSB 

DTISWBs for Presentation Services Abends 

DTISUTB 

DTISWBs for Utility Services Abends 

DTISVSB 

DTISWBs for VTAM Services Abends 

DTITXWB 

DTISWBs for Timer Services 

DTIUSWB 

DTISWBs for Utility Services 

DTIVSWB 

DTISWBs for VTAM Services 

DTIVXWB 

DTISWBs for VTAM Exit Services 

IN 

DTIWEB internal 

PB 

DTIPDB 

PD 

DTIDSB for Presentation Services 

PG 

DTIPGB 

PL 

DTIPLB 

SA 

DTISAB 

SM 

DTISDB 

TA 

DTITAB 

TD 

DTIGTD 

TR 

DTITHDR 

UG 

DTIUGB 

VD 

DTIDSB for VTAM Services 

VE 

DTIVEIB 

VG 

DTIVGB 

VL 

DTIVLB 

41 

DTIWEB IREAD internal read buffer 

1R 

DTIWEB IRECEIVE one-way reply 
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ID Control Block 


2R 

DTIWEB IRECEIVE one-way send 

IS 

DTIWEB ISEND one-way reply 

2S 

DTIWEB ISEND one-way send 

3R 

DTIWEB IRECEIVE two-way reply 

4R 

DTIWEB IRECEIVE two-way send 

3S 

DTIWEB ISEND two-way reply 

4S 

DTIWEB ISEND two-way send 
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Appendix F. PIU Discard Reason Codes 

vtam path information unit (piu) discard reason codes can be found in NetView 
trace panels and in the vtam Internal Trace (vit) dscd entry. When vtam’s trans¬ 
mission subsystem component (tsc) cannot forward a piu towards its final destina¬ 
tion, it generates a discard trace entry, consisting of a discard reason code and the 
discarded piu. The tsc sends the discard trace entry to the NetView program, or to 
the vit, or to both. 

Note: NetView must be active to vtam in order to accept discard trace entries. The 
vit must also be active. 

To reference all discard entries sent to NetView, issue the following NetView 
command: 

SESS ‘DISCARD 

NetView puts discarded Pius in this file and, when possible, also puts them in the 
associated session trace file. 

Because Pius are often discarded without causing problems in the network, most 
discarded Pius are not indicative of error conditions and do not need to be investi¬ 
gated. A discarded piu should be investigated only if an error symptom, such as a 
“hang” condition, occurs. 

For a description of NetView trace panels, see NetView installation and Operation. 

See Chapter 8, “Using the VTAM Internal Trace” on page 307 for a full description 
of the vit dscd entry. 
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Discard Reason Codes 

Figure 180 lists the vtam discard reason codes for each hs and tsc module that 
discards Pius, hs and tsc modules, with their associated reason codes, are listed in 
alphanumeric order. For each reason code, a specific reason is given for the 
discard, followed by a probable cause. Probable causes are described in more 
detail in Figure 181 on page 670. 


VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTHSCEP 

0001 

The session is being deactivated. 

Unsent Pius must be discarded. 

Should not occur 

0002 

The session is being deactivated. Pius 
on the pacing queue must be discarded. 

Should not occur 

0003 

The session is being deactivated. Pius 
on the hspab must be discarded. 


0004 

The session is being deactivated. Expe¬ 
dited flow Pius must be discarded. 

Should not occur 

ISTHSCGI 

0001 

Either insufficient resources, or lrm 
encounters an error while processing. 

Should not occur 

ISTTSCNS 

(No Session PAB 

Processor) 

0001 

No processing is required for this fido 

PIU. 

Timing consideration 
with bsc 3270 

ISTHSCRT 

0001 

A piu was received from another vtam 
component on the expedited work queue 
that is not a bind or unbind. 


0002 

An sc piu was received from the network 
that is not a bind or unbind. 

Should not occur 

ISTHSCRU 

0001 

Insufficient resources. 

Should not occur 

ISTHSCRV 

0001 

Format error on received request piu. 

Should not occur 

0002 

Format error on received response piu. 

Should not occur 

0003 

piu received in incorrect state. 

Should not occur 

0004 

Insufficient resources. 

Should not occur 

ISTHSCSN 

0001 

Chaining state error. 

Should not occur 

ISTHSCSR 

0001 

Chaining state error. 

Should not occur 

ISTHSCTP 

0001 

Insufficient resources. 

Should not occur 

0002 

Pacing response received when pacing 
is not supported. 

Should not occur 

ISTHSCTR 

0001 

Received piu caused Transmission 

Control protocol violation. 

Should not occur 


Figure 180 (Parti of 8). PIU Discard Reason Codes 
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VTAM Module 

Reason 

Code 

Reason lor Discard 

Probable Cause 

ISTTSCBR 

0001 

Invalid bdu command code. 


0002 

No response to the command in 
progress, or the command in progress 
has been sent again. 


0003 

Invalid control command. 


0004 

Not an error response, but set mode 
failed in processing completion of select 
bhset command. 


0005 

clear command in progress failed. 


ISTTSCCN 
(V3R1.2 and later) 

0001 

Device reset. 


ISTTSCCR 
(Connection Point 
Manager Receive) 

0001 

The request tscb is a pri.dt.send or a 
sec.dt.rcv in pending reset state. 

Timing on lu-lu session 
traffic 

0002 

Inbound fmd request when sscp-lu 
session is not active. 

Timing on sscp-lu 
session traffic 

ISTTSCGR 
(General Response 
Routine) 

0001 

Response could not be generated 
because the piu was fido, was not first in 
the segment, was already a response, or 
a response was not allowed by rh. 

Should not occur 

ISTTSCHT 
(V3R1.2 and later) 

0001 

piu is discarded from the put pending 
traffic queue. 


0002 

piu is discarded from the ncb pending 
traffic queue. 


0003 

piu is discarded from the ncb work 
queue. 

| 

0004 

piu is discarded from the ncb inbound 
router pab. 


ISTTSCIP 

(Host irn Processor) 

0001 

The route is not available to the destina¬ 
tion. 

Post-failure traffic purge 

; 0002 

A response cannot be generated. 

Post-failure traffic purge 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSCIS 
(Inbound Session 
Control Function 
Interpreter) 

0001 

The response is discarded when 
pri.sess.send is not in a pending active 
state. 

Timing on lu-lu session 
traffic. 


0002 

The response is discarded when 
pri.dt.send is not in a pending active 
state. 

Timing on lu-lu session 
traffic. 


0003 

The response is discarded when 
pri.ot.send is not in a pending reset 
state. 

Timing on lu-lu session 
traffic. 


0004 

The response is discarded when 
rqr.send is not in a pending state. 

Timing on lu-lu traffic 


0005 

The response is discarded when 
pri.sess.send or sec.sess.rcv is not in an 
active state. 

Timing on lu-lu session 
traffic 


0006 

The session control response is invalid. 

Should not occur — 
logical unit error 


0007 

Last in segment not received. 

Should not occur — 
logical unit error 

ISTTSCIU 
(Host irn Utility 
Processor) 

0001 

The link is not contacted and active. 

Post-failure traffic purge 


0002 

No irn extension exists on the ncb. 

Post-failure traffic purge 

ISTTSCJS 
(V3R1.2 and later) 

0001 

pius discarded from bct pending traffic 
queue for logical unit session control 
request. 



0002 

Plus discarded from bsclb waiting 
printer end queue for logical unit 
session control request. 



0003 

Plus discarded from bct pending traffic 
queue for pu session control request. 



0004 

pius discarded from bsclb waiting 
printer end queue for pu session control 
request. 



Figure 180 (Part 3 of 8). PIU Discard Reason Codes 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSCJT 
(V3R1.2 and later) 

0001 

piu is discarded from the bct pending 
traffic queue. 


0002 

piu is discarded from the bsclb waiting 
printer end queue. 


0003 

piu is discarded from the pcpab work 

queue. 


0004 

piu is discarded from the bsclb inbound 

router pab. 


ISTTSCLS 
(Local 3270 Write 
Scheduler) 

0001 

The link is not yet active. 

Post-failure traffic purge 

0002 

The request was purged because of the 
session control request that followed. 

Timing on lu-lu session 
traffic 

VM ISTTSCMB 
(Migration bind, 

UNBIND, ACTCDRM, 
DACTCDRM 

Processor) 

0001 

This is not a migration route. 

Should not occur, or 
route has been rede¬ 
fined. 

0002 

The icncb was not found. 

Post-failure traffic purge 

0003 

The virtual route (vr) number and the 
transmission priority (tp) number are not 

0, as they must be for migration. 

Should not occur— vr 

and tp numbers must be 

0 for migration 

ISTTSCNC 
(Network Control 
Function Inter¬ 
preter) 

0001 

The initialization complete request is the 
only inbound request allowed from 
network control. 

Should not occur — error 
in network 

ISTTSCNS 

(No Session pab 

Processor) 

0001 

No processing is required for this fido 
piu. 

Timing consideration 
with bsc 3270 

ISTTSCPI 
(Path Control 

Inbound Processor) 

0001 

The ru size is exceeded, and the piu is 
not for session control. 

Logical unit problem — 
logical unit sent a piu 
larger than the BiND-spec- 
ified maximum 

ISTTSCPR 
(Path Control 

Router) 

0001 

A response cannot be generated for an 

IRN PIU. 

Post-failure traffic purge 

ISTTSCQD 
(Session Deacti¬ 
vation Request 
Processor) 

0001 

A contention actcdrm was discarded 

because a dactcdrm arrived from the 

same subarea. 

Operation — operator 
deactivated cdrm from 

one host after activation 

ISTTSCQF 
(V3R1.2 and later) 

0001 

Abend recovery piu discard 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSCQP 
(Session Deacti¬ 
vation Processor) 

0001 

an actcdrm was discarded due to 
actcdrm contention session restart. 

Operation — cdrm acti¬ 
vated from both hosts 
simultaneously 

ISTTSCRA 
(Abend Recovery) 

0001 

This is not a “first-in-segment" piu. 

Post-failure traffic purge 
after application program 
abend 

ISTTSCRI 

(Virtual Route Path 
Control Inbound) 

0001 

The origin subarea is invalid. 

Should not occur — adja¬ 
cent ncp error 

0002 

The route is not usable. 

Post-failure traffic purge 
— er not operative 

0003 

The sequence number is invalid. 

Should not occur — lost 
data or logical unit error 

ISTTSCRO 
(Virtual Route Path 
Control Outbound) 

0001 

The route is not active. 

Post-failure traffic purge 

0002 

The activation number does not match 
the vr activation number. 

Post-failure traffic purge 

ISTTSCSA 
(Segment Assem¬ 
bler) 

0001 

The beginning of the piu segment was 
lost. 

Should not occur — 
network error 

0002 

Two “First-in-Segment” Pius were 
received. Discard the partial piu 
segment and retransmit the piu. 

Should not occur — check 
logical unit 

0003 

Hot I/O. Discard all piu segments for this 
session. 

Should not occur —check 
logical unit 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSCSR 
(Session Router) 

0001 

Incorrect virtual route id. 

Should not occur — piu 
originator error 


0002 

A complete dactcdrm request caused by 
contention resolution, session override, 
or other session outage notification. 

Network operator error 
or transmission group 
failure 


0003 

Session deactivation response and state 
is not pending reset. 

Should not occur — out of 
synchronization. Pos¬ 
sibly misrouted. 


0004 

Negative session activation response 
and flow direction does not match the 
direction indicator. 

Should not occur — piu 
originator error 


0005 

Negative session activation response 
and invalid sequence number. 

Should not occur — out of 
synchronization or lost 
traffic 


0006 

Negative session activation response 
and state is not pending active. 

Out of synchronization — 
multiple session acti¬ 
vation and deactivation 
running concurrently 


0007 

The session control response piu is not 
flagged as expedited flow. 

Protocol violation by the 
response originator 


Figure 180 (Part 6 of 8). PIU Discard Reason Codes 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSCTS 
(Boundary Function 
Transmission 

Control Inbound) 

0001 

(sscp.puj.bf.sess.rcv is not pending 
active for the actpu response, vtam was 
not waiting for an actpu response. 

Should not occur — out of 
synchronization on 
sscp-pu session 


0002 

(sscp.puj.bf.sess.rcv is not pending reset 
for the dactpu response, vtam was not 
waiting for a dactpu response. 

Should not occur — out of 
synchronization on 

SSCP-PU 


0003 

(sscp.sluj.bf.sess.rcv is not pending 
active for the actlu response, vtam was 
not waiting for an actlu response. 

Should not occur — out of 
synchronization on 
sscp-lu session 


0004 

(sscp.luj.bf.sess.rcv is not pending reset 
for the dactlu response, vtam was not 
waiting for a dactlu response. 

Should not occur — out of 
synchronization on 
sscp-lu session 


0005 

(plu.sluj.bf.sess.rcv is not pending 
active for the bind response, vtam was 
not waiting for a bind response. 

Timing between sscp 
sessions and lu-lu 
session — sscp session 
reset during logical unit 
session activation 


0006 

(plu.sluj.bf.sess.rcv is not pending 
active for the unbind response, vtam was 
not waiting for an unbind response. 

Timing between sscp 
sessions and lu-lu 
session — sscp session 
reset during logical unit 
session deactivation 

ISTTSCWS 
(Communication 
Controller/Cluster 
Controller Write 
Scheduler) 

0001 

The channel link has not been contacted. 

Post-failure traffic purge 

ISTTSCXS 
(Channel-to- 
Channel Attach¬ 
ment Write 

Scheduler) 

0001 

The channel link is not in contacted or 
active state. 

Post-failure traffic purge 

ISTTSC3R 

(3270 Virtual pu/lu 

Transmission 

Control Outbound) 

0001 

dt.rcv is not active. 

Timing on lu-lu session 
traffic 


0002 

The session is being reset. 

Timing on lu-lu session 
traffic 
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VTAM Module 

Reason 

Code 

Reason for Discard 

Probable Cause 

ISTTSC3S 

(3270 Virtual pu/lu 

Transmission 

Control Inbound) 

0001 

The session was not active, and the piu 
received did not contain a session 
control ru. 

Timing on lu-lu session 
traffic 


0002 

(sscp.pu).sec.sess.rcv is not pending 
active for the actpu response, vtam was 
not waiting for an actpu response. 

Should not occur — out of 
synchronization on 
sscp-pu session 


0003 

(sscp.pu).sec.sess.rcv is not pending 
reset for the dactpu response, vtam was 
not waiting for a dactpu response. 

Should not occur — out of 
synchronization on 
sscp-pu session 


0004 

(sscp.slu).sec.sess.rcv is not pending 
active for the actlu response, vtam was 
not waiting for an actlu response. 

Timing between sscp-pu 
and sscp-lu sessions 


0005 

(sscp.slu).sec.sess.rcv is not pending 
reset for the dactlu response, vtam was 
not waiting for a dactlu response. 

Timing between sscp-pu 
and sscp-lu sessions 


0006 

(plu.slu).sec.sess.rcv is not pending 
active for a bind response, vtam was not 
waiting for a bind response. 

Timing between sscp 
sessions and lu-lu 
session — sscp session 
reset during lu-lu 
session activation 


0007 

(plu.sluj.sec.sess.rcv is not pending 
reset for the unbind response, vtam was 
not waiting for an unbind response. 

Timing between sscp 
sessions and lu-lu 
session — sscp session 
reset during lu-lu 
session deactivation 


0008 

For an lu-lu session, the 
datatraffic_rcv is not active. 

Timing on lu-lu session 
traffic 

ISTTSC6F 

! 

No discard codes from this module. 

Using tsalert with reason code 0 for 
normal piu discard. 


ISTTSC6Z 
(V3R1.2 and later) 

0001 

End of piu lost 

Should not occur — error 
in network 


0002 

Retransmission of piu, discard the 
partial piu. 

Should not occur — error 
in network 


0003 

Segmenting length error 

Should not occur — error 
in network 


0004 

Queue freed — segmenting error 

Should not occur — error 
in network 
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Probable Causes of Discards 


Probable Cause 

Explanation of Cause 

Timing on lu-lu 
session traffic 

This discard can occur on the session between the application program and 
the slu. It is usually caused by a reset request (for example, a Clear or a 
bind) from the application program. This type of discard does not usually 
cause a problem in the network. 

Timing between sscp 
sessions and lu-lu 
session 

This discard usually occurs when a reset of the sscp-pu or sscp-lu session 
affects a pending initiation or termination of the lu-lu session. For example, if 
the application program issues a clsdst request to the logical unit, vtam 
sends an unbind request to the logical unit. If the sscp-lu session fails before 
the unbind response comes back, the unbind response is discarded. This type 
of discard does not usually cause a problem in the network. 

Timing between 
sscp-pu and sscp-lu 
sessions 

This discard usually occurs when a reset of the sscp-pu session affects a 
pending initiation or termination of the sscp-lu session. For example, if the 
operator deactivates the logical unit, vtam sends a dactlu to the logical unit. 

If the sscp-pu session fails before the dactlu response comes back, the dactlu 
response is discarded. This type of discard does not cause a problem in the 
network. 

Post-failure traffic 
purge 

This discard may be caused by a network failure. Any piu traffic arriving after 
the network failure but before the session is terminated can be purged using 
the discard function. For example, after a channel i/o error, Pius that continue 
to be queued outbound over the channel can be discarded. This type of 
discard does not usually cause a problem in the network. 

Should not occur 

This discard indicates a hardware or software error in the network; it usually 
occurs after a major sna protocol violation. For example, if vtam is waiting for 
a sequence number of 0008 but receives a piu with sequence number 0010, 

Pius with sequence numbers 0008 and 0009 are missing. The missing Pius 
could have been lost anywhere in the session path, or perhaps they were not 
sent. The logical unit, physical unit, line, ncp, channel, or vtam might be 
responsible for the problem. 

Further investigation is usually required to determine where in the network 
the problem is. The session type and reason code determine what type of 
documentation is needed to resolve a problem identified by this discard code. 


Figure 181. Probable Causes of Discards 
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grammer to customize vtam and tune it for better per¬ 
formance. It discusses modifying vtam messages; 
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VTAM Directory of Programming Interfaces for Cus¬ 
tomers (GC31-6403) 
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is also a guide for system programmers who must 
supply operators with the detailed information that they 
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This book includes an introduction to operating vtam, a 
description of vtam commands, and a description of 
how to use vtam commands to perform network control 
functions. 

VTAM Messages and Codes (SC23-0114) 

This book contains, in alphanumerical order, all mes¬ 
sages and codes issued by vtam. These messages 
include vtam messages for network operators, tso/vtam 


messages for network operators, tso/vtam messages 
for terminal users, uss messages for terminal users, 
and vscs messages. 
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messages book, if desired, or used as a stand-alone 
book. 

VTAM Programming (SC23-0115) 

This book describes how to use vtam macroinstructions 
to send data to and receive data from (1) a terminal in 
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VTAM Data Areas for VSE (LY30-5594) 
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to read a vtam dump. They are intended for ibm pro¬ 
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sonnel who are diagnosing problems with vtam. 

VTAM Reference Summary (LY30-5600) 

This book is designed as a quick reference for system 
programmers and network programmers. This book 
contains selected reference information that includes 
vtam and vscs commands, vtam definition statements, 
vtam start options, vtam macroinstructions, vtam and 
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Other Network Program 
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ography and Master Index, 

The following list shows the cross-product books for 
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Network Program Products Storage Estimates 
(SC30-3403) 

NetView Books 

The following list shows the books associated with 
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List of Abbreviations 

ACB. Application control block. 

ACDEB. VTAM data extent block. 

ACF. Advanced Communications Function. 

ACF/NCP. Advanced Communications Function for the 
Network Control Program. 

ACF/SSP. Advanced Communications Function for the 
System Support Programs. 

ACF/TAP. Advanced Communications Function for the 
Trace Analysis Program. 

ACF/TCAM. Advanced Communications Function for 
the Telecommunications Access Method. 

ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 

ACTLINK. Activate Link. 

ACTLU. Activate logical unit. 

ACTPU. Activate physical unit. 

ANA. Assign network address. 

AP. Alternate printer. 

API. Application program interface. 

APPC. Advanced Program-to-Program Communication 

APPL. Application program. 

APUNS. Adjacent physical unit network services. 

ASCII. American National Standard Code for Informa¬ 
tion Interchange. 

ATCVT. VTAM communication vector table. 

AVT. Address vector table. 

BFT. Boundary function table. 

BHSET. Block handler routines. 

BIU. Basic information unit. 

BNN. Boundary network node. 

BSC. Binary synchronous communication. 
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BTU. Basic transmission unit. 

CA. Channel adapter. 

CA/CS. Continue any/continue specific. 

CC. Command chaining. 

CCP. Configuration control program facility. 

CCS. Console communication services. 

CCW. Channel command word. 

CDRM. Cross-domain resource manager. 

CDRSC. Cross-domain resource. 

CDS. Configuration data set. 

CDSESSEND. Cross-domain session ended. 
CDSESSST. Cross-domain session started. 

CGB. Communication services global block. 

CICS. Customer Information Control System. 

CID. Communication identifier. 

CLB. Communication services local block. 

CLSDST. Close destination. 

CMS. Conversational Monitor System. 

CNM. Communication network management. 

CNOS. Change number of sessions. 

CONFT. VTAM configuration table. 

COS. Class of service. 

CP. Control program. 

CPCB. Control point control block. 

CRA. Component recovery area. 

CRR. Component recovery record. 

CRV. Cryptography verification. 

CS. Current state. 
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CSA. Common service area. 

CSP. Communication scanner processor. 

CSW. Channel status word. 

CT. Control terminal. 

QUA. Channel unit address. 

CVT. Communication vector table. 

DACTLINK. Deactivate link. 

DACTLU. Deactivate logical unit. 

DACTPU. Deactivate physical unit. 

DAF. Destination address field. 

DAN. Direct attachment node. 

DBCS. Double-byte character set. 

DC. Data chaining. 

DCE. Data circuit-terminating equipment. 

DET. Device entry table. 

DEV. Device address field. 

DFC. Data flow control. 

DLC. Data link control. 

DLRPL. Dump/load/restart parameter list. 

DLU. Destination logical unit. 

DOC. Documentation. 

DPN. Destination program name. 

DR. Definite response. 

DRDS. Dynamic reconfiguration data set. 

DS. Desired state. 

DSB. Dispatcher/scheduler block 

DTE. Data terminal equipment. 

DVT. Destination vector table. 

EBCDIC. Extended binary-coded decimal interchange 
code. 

EC. Engineering change. 


ECB. Event control block. 

ED. Enciphered data. 

EIA. Electronic Industries Association. 

EIB. External interrupt block. 

EID. Event identifier. 

EIS. External interrupt support. 

EL. Error loop. 

EOT. End-of-transmission. 

EP. Emulation Program. 

EPCF. Extended primary control field. 

ER. Explicit route. 

ERACT. Error action. 

ERCOD. Error code. 

EREP. Environmental recording editing and printing. 
ERP. Error recovery procedure. 

E/T. Error-to-traffic. 

EXLST. Exit list. 

EXR. Exception request. 

FDX. Full duplex. 

FIC. First-in-chain. 

FID. Format identification. 

FIFO. First-in first-out. 

FMCB. Function management control block. 

FMD. Function management data. 

FMH. Function management header. 

FNA. Free network address. 

FSSM. Full screen support mode. 

GCS. Group control system. 

GPT. Generalized path information unit trace. 

GTD. Global timer data block. 

HPO. High Performance Option. 
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GTF. Generalized trace facility. 

GVM. Guest virtual machine. 

HIO. Halt I/O. 

ICNCB. Intelligent controller node control block. 

ICW. Interface control word. 

ID. Identification. 

IMR. Intensive mode recording. 

IMS. Information Management System/Virtual Storage. 

IMS/VS. Information Management System/Virtual 
Storage. 

I/O. Input/output. 

IOPD. Input/output problem determination. 

IPCS. Interactive problem control system. 

IRN. Intermediate routing node. 

IUCV. Inter-user communication vehicle. 

JCL. Job control language. 

LCB. Local block common. 

LCD. Line control definer. 

LDNCB. Local device node control block. 

LFSM. Link function state machine. 

LIFO. Last-in first-out. 

LL2. Link level 2. 

LMPEO. Large message performance enhancement 
outbound. 

LPA. Link pack area. 

LQAB. Lock queue anchor block. 

LSID. Local session identification. 

LU. Logical unit. 

LUCB. Logical unit control block. 

LUS. Logical unit services. 

LUST. Logical unit status table. 

LU 6.2. Logical unit 6.2. 


MDR. Miscellaneous data record. 

ML Manual intervention. 

MIC. Middle-in-chain. 

MID. Machine identifier. 

MOSS. Maintenance and operator subsystem. 

MSG. Console messages. 

MSHP. Maintain system history program. 

MVS. Multiple Virtual Storage operating system. 

MVS/XA. Multiple Virtual Storage for Extended Archi¬ 
tecture operating system. 

NAB. Network address block. 

NAU. Network addressable unit. 

NC. Network control. 

NCB. Node control block. 

NCCF. Network Communications Control Facility. 

NCP. Network Control Program. 

NCSPL. Network configuration services parameter list. 
NFY. Notify. 

NIB. Node initialization block. 

NLDM. Network Logical Data Manager. 

NMVT. Network management vector transport. 

NPDA. Network Problem Determination Application. 
NPR. No print. 

NR. Negative response. 

NRF. Network Routing Facility. 

NS. Network services. 

NSI. Non-SNA Interconnection. 

NTO. Network Terminal Option. 

OACBRU. Open ACB request/response unit. 

OAF. Origin address field. 

OBR. Outboard record. 
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OIC. Only-in-chain. 

OLU. Origin logical unit. 

OPNDST. Open destination. 

OPT. Option. 

OS. Operating system. 

PAB. Process anchor block. 

PC. Path control. 

PCB. Pool control block. 

PCF. Primary control field. 

PCID. Procedure-correlation identifier. 

PDB. Pool descriptor block. 

PDF. Parallel data field. 

PEP. Partitioned emulation program. 

PERFM. Performance. 

PGB. Presentation services global block. 
PIB. Process information block. 

PIU. Path information unit. 

PLB. Presentation services local block. 

PLM. Program logic manual. 

PLU. Primary logical unit. 

PP. Parallel print. 

PR. Print error. 

PROGCK. Program check. 

PRN. Primary resource name. 

PSS. Process scheduling services. 

PST. Process scheduling table. 

PSW. Program status word. 

PTF. Program temporary fix. 

PU. Physical unit. 

PUNS. Physical unit services. 

PUSCB. Physical unit services control block. 


PUT. Program update tape. 

PVI. Primitive VTAM interface. 

PXB. Pool extension block. 

QAB. Queue anchor block. 

RAS. Reliability, availability, and serviceability. 

RCA. Resident common area. 

RDT. Resource definition table. 

RDTE. Resource definition table entry. 

REA. Request for Engineering Activity. 

RECFMS. Record formatted maintenance statistics. 
RECMS. Record maintenance statistics. 

REGS. Registers. 

REX. Route extension. 

RFT. Request for test. 

RH. Request/response header. 

RNAA. Request network address assignment. 

RPH. Request parameter header. 

RPL. Request parameter list. 

RTI. Response type indicator. 

RTM. Response time monitor. 

RU. Request/response unit. 

RUPE. Request/response unit processing element. 
SAB. Service application block. 

SADP. Serviceability aids and debugging procedures. 
SAF. Source address field. 

SAW. Session awareness. 

SBA. Set buffer address. 

SC. Session control. 

SCF. Secondary control field. 

SCT. Section control table. 
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SDA. Sense data included. 

SDB. Storage descriptor block. 

SDF. Serial data field. 

SDLC. Synchronous Data Link Control. 

SDT. Start data traffic. 

SDVT. Skeleton destination vector table. 

SDWA. System diagnostic work area. 

SESSEND. Session ended. 

SESSER. Session serialization. 

SESSST. Session started. 

SIB. Session information block. 

SIO. Start I/O. 

SIT. Scanner interface trace. 

SLT. Section list table. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SMP. System Modification Program. 

SMP/E. System Modification Program Extended. 
SMS. Storage management services. 

SNA. Systems Network Architecture. 

SNI. SNA network interconnection. 

SP. Service point. 

SPANC. Storage pool anchor block. 

SPCS. Service point command service. 

SRT. Symbol resolution table. 

SRTD. Symbol resolution table directory. 

SRTE. Symbol resolution table entry. 

SS. Start-stop. 

SSCP. System services control point. 

SSP. System Support Programs. 

STD. Set control vector time and date. 


STSN. Set and test sequence numbers. 

SVA. Shared virtual area. 

SVC. Switched virtual circuit. 

SWB. Save/Work block. 

SYSDEF. System definition. 

SYSREC. System error file. 

TAB. Terminal anchor block. 

TAP. Trace analysis program. 

TC. Transmission control. 

TCAM. Telecommunications Access Method. 
TCAS. Terminal control address space. 

TCB. Task control block. 

TECT. Temporary error counter. 

TG. Transmission group. 

TH. Transmission header. 

TIB. Task information block. 

TIC. Token-ring interface coupler. 

TID. Task identifier. 

TIK. Task identification key. 

TL. Test loop. 

TNSTAT. Tuning statistics. 

TP. Transmission priority. 

TPRINT. Trace print. 

TR. Trace. 

TRAC. Trace record. 

TRCPL. Trace parameter list. 

TRFILE. Trace file. 

TSC. Transmission subsystem component. 
TSCB. Transmission subsystem control block. 
TSO. Time sharing option. 
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TSO/VTAM. Time sharing option for VTAM. 

TSPL. Transmission subsystem parameter list 
TT. Test terminal. 

TWA. Test work area. 

TWX. Teletypewriter exchange service. 

UECB. User exit control block. 

UGB. Utilities services task global block. 

USS. Unformatted system services. 

VEIB. Virtual external interrupt block. 

VGB. VTAM services global block. 

VIT. VTAM internal trace. 

VLB. VTAM services local block. 

VM. Virtual Machine operating system. 

VM/SP. Virtual Machine/System Product operating 
system. 

VP. Variable pageable. 

VR. Virtual route. 

VS. Virtual storage. 


VSAM. Virtual Storage Access Method. 

VSCS. VM SNA console support. 

VSE. Virtual Storage Extended operating system. 

VSE/AF. Virtual Storage Extended/Advanced Functions 
operating system. 

VSE/SP. Virtual Storage Extended/System Package 
operating system. 

VSM. VTAM service machine. 

VTAM. Virtual Telecommunications Access Method. 

VTIOC. VTAM Terminal I/O Coordinator. 

WEB. Work element block. 

WRE. Waiting request element. 

XID. Exchange identification. 

XMT. Transmit buffer information. 

XREF. cross-reference. 

XRF. Extended recovery facility. 

X.21. Recommendation X.21 (Geneva 1980) 

X.25. Recommendation X.25 (Geneva 1980) 
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Glossary 


This glossary defines important NCP, NetView, 
NetView/PC, SSP, and VTAM abbreviations and terms. 

It includes information from the IBM Vocabulary for 
Data Processing, Telecommunications, and Office 
Systems, GC20-1699. Definitions from the American 
National Dictionary for Information Processing are 
identified by an asterisk (*). Definitions from draft pro¬ 
posals and working papers under development by the 
International Standards Organization, Technical Com¬ 
mittee 97, Subcommittee 1 are identified by the symbol 
(TC97). Definitions from the CCIT Sixth Plenary 
Assembly Orange Book, Terms and Definitions and 
working documents published by the Consultative Com¬ 
mittee on International Telegraph and Telephone of the 
International Telecommunication Union, Geneva, 1980 
are preceded by the symbol (CCITT/ITU). Definitions 
from published sections of the ISO Vocabulary of Data 
Processing , developed by the International Standards 
Organization, Technical Committee 97, Subcommittee 1 
and from published sections of the ISO Vocabulary of 
Office Machines , developed by subcommittees of ISO 
Technical Committee 95, are preceded by the symbol 
(ISO). 

For abbreviations, the definition usually consists only of 
the words represented by the letters; for complete defi¬ 
nitions, see the entries for the words. 

Reference Words Used in the Entries 

The following reference words are used in this 
glossary: 

Deprecated term for. Indicates that the term 
should not be used. It refers to a preferred term, 
which is defined. 

Synonymous with. Appears in the commentary of 
a preferred term and identifies less desirable or 
less specific terms that have the same meaning. 

Synonym for . Appears in the commentary of a less 
desirable or less specific term and identifies the 
preferred term that has the same meaning. 

Contrast with. Refers to a term that has an 
opposed or substantively different meaning. 

See. Refers to multiple-word terms that have the 
same last word. 

See also. Refers to related terms that have similar 
(but not synonymous) meanings. 


abend. Abnormal end of task. 


abnormal end of task (abend). Termination of a task 
before its completion because of an error condition that 
cannot be resolved by recovery facilities while the task 
is executing. 

ACB. (1) In VTAM, application control block. (2) In 
NCP, adapter control block. 

ACB name. (1) The name of an ACB macroinstruction. 
(2) A name specified in the ACBNAME parameter of a 
VTAM APPL statement. Contrast with network name. 

accept. For a VTAM application program, to establish a 
session with a logical unit (LU) in response to a CINIT 
request from a system services control point (SSCP). 
The session-initiation request may begin when a ter¬ 
minal user logs on, a VTAM application program issues 
a macroinstruction, or a VTAM operator issues a 
command. See also acquire (1). 

access method. A technique for moving data between 
main storage and input/output devices. 

accounting exit routine. In VTAM, an optional installa¬ 
tion exit routine that collects statistics about session 
initiation and termination. 

ACF. Advanced Communications Function. 

ACF/NCP. Advanced Communications Function for the 
Network Control Program. Synonym for NCP. 

ACF/SSP. Advanced Communications Function for the 
System Support Programs. Synonym for SSP. 

ACF/TAP. Advanced Communications Function for the 
Trace Analysis Program. Synonym for TAP. 

ACF/TCAM. Advanced Communications Function for 
the Telecommunications Access Method. Synonym for 
TCAM. 

ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VTAM. 

acquire. (1) For a VTAM application program, to ini¬ 
tiate and establish a session with another logical unit 
(LU). The acquire process begins when the application 
program issues a macroinstruction. See also accept. 

(2) To take over resources that were formerly con¬ 
trolled by an access method in another domain, or to 
resume control of resources that were controlled by 
this domain but released. Contrast with release. See 
also resource takeover. 
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activate. To make a resource of a node ready to 
perform the functions for which it was designed. Con¬ 
trast with deactivate . 

active. (1) The state a resource is in when it has been 
activated and is operational. Contrast with inactive, 
pending, and inoperative. (2) Pertaining to a major or 
minor node that has been activated by VTAM. Most 
resources are activated as part of VTAM start proc¬ 
essing or as the result of a VARY ACT command. 

active application. The application subsystem currently 
in an extended recovery facility (XRP) session with a 
terminal user. See aiternate appiication. 

adapter. Hardware card that allows a device, such as a 
PC, to communicate with another device, such as a 
monitor, a printer, or other I/O device. 

adapter control block (ACB). In NCP, a control block 
that contains line control information and the states of 
I/O operations for BSC lines, SS lines, or SDLC links. 

adaptive session pacing. Synonym for adaptive 
session-level pacing. 

adaptive session-level pacing. A form of session-level 
pacing in which session components exchange pacing 
windows that may vary in size during the course of a 
session. This allows transmission to adapt dynamically 
to variations in availability and demand of buffers on a 
session by session basis. Session pacing occurs 
within independent stages along the session path 
according to local congestion at the intermediate 
nodes. Synonymous with adaptive session pacing . 

See pacing , session-level pacing , and virtual route 
pacing. 

address translation. See network address translation. 

adjacent networks. Two SNA networks joined by a 
common gateway NCP. 

adjacent nodes. Two nodes that are connected by one 
or more data links with no intervening nodes. 

Advanced Communications Function (ACF). A group of 
IBM licensed programs (principally VTAM, TCAM, NCP, 
and SSP) that use the concepts of Systems Network 
Architecture (SNA), including distribution of function 
and resource sharing. 

Advanced Program-to-Program Communication 
(APPC). A synonym for logical unit (LU) 6.2 and its 
implementations. 

alert. (1) In SNA, a record sent to a system problem 
management focal point to communicate the existence 
of an alert condition. (2) In the NetView program, a 
high priority event that warrants immediate attention. 


This data base record is generated for certain event 
types that are defined by user-constructed filters. 

alert condition. A problem or impending problem for 
which some or all of the process of problem determi¬ 
nation, diagnosis, and resolution is expected to require 
action at a control point. 

alias name. A name defined in a host used to repre¬ 
sent a logical unit name, logon mode table name, or 
class-of-service name in another network. This name 
is defined to a name translation program when the 
alias name does not match the real name. The alias 
name translation program is used to associate the real 
and alias names. 

allocate. A logical unit (LU) 6.2 application program 
interface (API) verb used to assign a session to a con¬ 
versation for the conversation's use. Contrast with 
deallocate. 

alternate application. The subsystem that is prepared 
to take over a particular active application's extended 
recovery facility (XRF) sessions with terminal users in 
case the application fails. See active application. 

API. Application program interface. 

APPC. Advanced Program-to-Program Communication. 

application control block (ACB). A control block that 
links an application program to VSAM or VTAM. 

application program. (1) A program written for or by a 
user that applies to the user's work. (2) A program 
used to connect and communicate with stations in a 
network, enabling users to perform application-oriented 
activities. 

application program exit routine. In VTAM, a user- 
written exit routine that performs functions for a partic¬ 
ular application program and is run as part of the 
application program. Examples are the RPL exit 
routine, the EXLST exit routine, and the TESTCB exit 
routine. Contrast with installation exit routine. 

application program interface (API). (1) The formally 
defined programming language interface between an 
IBM system control program or licensed program and 
its user. (2) The interface through which an application 
program interacts with an access method. In VTAM, it 
is the language structure used in control blocks so that 
application programs can reference them and be identi¬ 
fied to VTAM. 

application program major node. A group of applica¬ 
tion program minor nodes. In the VTAM definition 
library, it is a member, book, or file that contains one 
or more APPL statements, which represent application 
programs. In MVS, it is a member of the library; in 
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VSE, it is a book; and in VM, it is a CMS file of filetype 
VTAMLST. 

ASCII. American National Standard Code for Informa¬ 
tion Interchange. 

asynchronous operation. Simultaneous operations of 
software or hardware. In software, an operation, such 
as a request for session establishment or data transfer, 
in which the application program is allowed to continue 
execution while the operation is performed. The 
access method informs the application program after 
the operation is completed. Contrast with synchronous 
operation. 

asynchronous request. In VTAM, a request for an asyn¬ 
chronous operation. Contrast with synchronous 
request. 

authorization exit routine, in VTAM, an optional instal¬ 
lation exit routine that approves or disapproves 
requests for session initiation. 

authorized path, in VTAM for MVS, a facility that 
enables an application program to specify that a data 
transfer or related operation be carried out in a privi¬ 
leged and more efficient manner. 

automatic logon. (1) A process by which VTAM auto¬ 
matically creates a session-initiation request to estab¬ 
lish a session between two logical units (LUs). The 
session will be between a designated primary logical 
unit (PLU) and a secondary logical unit (SLU) that is 
neither queued for nor in session with another PLU. 

See also controlling application program and control¬ 
ling logical unit. (2) In VM, a process by which a 
virtual machine is initiated by other than the user of 
that virtual machine. For example, the primary VM 
operator's virtual machine is activated automatically 
during VM initialization. 

available. In VTAM, pertaining to a logical unit that is 
active, connected, enabled, and not at its session limit. 

back-level. Pertaining to an earlier release of an IBM 
product, which may not support a particular, current 
function. 

backup session. The session that replaces the failing 
primary extended recovery facility (XRF) session 
between a terminal user and the active subsystem. 

basic conversation. A conversation that supports the 
functions of the basic conversation protocol boundary 
defined by LU 6.2. That format requires data to be sent 
as logical records consisting of a 2-byte length prefix 
followed by the data. See also mapped conversation. 

basic information unit (BIU). In SNA, the unit of data 
and control information that is passed between half¬ 


sessions. It consists of a request/response header 
(RH) followed by a request/response unit (RU). 

basic transmission unit (BTU). In SNA, the unit of data 
and control information passed between path control 
components. A BTU can consist of one or more path 
information units (PIUs). See also blocking ofPIUs. 

begin bracket. In SNA, the value (binary 1) of the 
begin-bracket indicator in the request header (RH) of 
the first request in the first chain of a bracket; the value 
denotes the start of a bracket. Contrast with end 
bracket. See also bracket 

bidder. In SNA, the LU-LU half-session defined at 
session activation as having to request and receive 
permission from the other LU-LU half-session to begin 
a bracket. Contrast with first speaker. See also 
bracket protocol and contention. 

binary synchronous communication (BSC). (1) Com¬ 
munication using binary synchronous line discipline. 

(2) A uniform procedure, using a standardized set of 
control characters and control character sequences, for 
synchronous transmission of binary-coded data 
between stations. 

bind. In SNA, a request to activate a session between 
two logical units (LUs). See also session activation 
request. Contrast with UNBIND. 

BiU. Basic information unit. 

BIU segment. In SNA, the portion of a basic information 
unit (BIU) that is contained within a path information 
unit (PIU). It consists of either a request/response 
header (RH) followed by all or a portion of a 
request/response unit (RU), or only a portion of an RU. 

blocking of PIUs. In SNA, an optional function of path 
control that combines multiple path information units 
(PIUs) into a single basic transmission unit (BTU). 

BNN. Boundary network node. 

boundary function. (1) A capability of a subarea node 
to provide protocol support for attached peripheral 
nodes, such as: (a) interconnecting subarea path 
control and peripheral path control elements, (b) per¬ 
forming session sequence numbering for low-function 
peripheral nodes, and (c) providing session-level 
pacing support. (2) The component that provides these 
capabilities. See also boundary node , network 
addressable unit (NAU), peripheral path control , 
subarea node , and subarea path control. 

boundary network node (BNN). Deprecated term for 
boundary node . 

boundary node. (1) A subarea node with boundary 
function. See subarea node (including illustration). 
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See also boundary function. (2) The programming 
component that performs FID2 (format identification 
type 2) conversion, channel data link control, pacing, 
and channel or device error recovery procedures for a 
locally attached station. These functions are similar to 
those performed by a network control program for an 
NCP-attached station. 

bracket In SNA, one or more chains of request units 
(RUs) and their responses that are exchanged between 
the two LU-LU half-sessions and that represent a trans¬ 
action between them. A bracket must be completed 
before another bracket can be started. Examples of 
brackets are data base inquiries/replies, update trans¬ 
actions, and remote job entry output sequences to work 
stations. See also begin bracket and end bracket. 

bracket protocol. In SNA, a data flow control protocol 
in which exchanges between the two LU-LU half¬ 
sessions are achieved through the use of brackets, with 
one LU designated at session activation as the first 
speaker and the other as the bidder. The bracket pro¬ 
tocol involves bracket initiation and termination rules. 
See also bidder and first speaker. 

BSC. Binary synchronous communication. 

BTU. Basic transmission unit. 

buffer. A portion of storage for temporarily holding 
input or output data. 

cancel closedown. A closedown in which VTAM is 
abnormally terminated either because of an unex¬ 
pected situation or as the result of an operator 
command. See also orderiy closedown and quick 
closedown. 

CCP. Configuration control program facility. 

CCS. Console communication services. 

CDRM. Cross-domain resource manager. 

CDRSC. Cross-domain resource, 
chain. See RU chain. 

channel. * A path along which signals can be sent, for 
example, data channel, output channel. See data 
channel and input/output channel. See also link. 

channel adapter. A communication controller hard¬ 
ware unit used to attach the controller to a System/360 
or a System/370 channel. 

channel-attached. Pertaining to the attachment of 
devices directly by System 370 input-output channels to 
a host processor. 


channel-attachment major node. (1) A major node that 
includes an NCP that is channel-attached to a data host. 

(2) A major node that may include minor nodes that 
are the line groups and lines that represent a channel 
attachment to an adjacent (channel-attached) host. 

(3) In VM or VSE operating systems, a major node that 
may include minor nodes that are resources (host 
processors, NCPs, line groups, lines, SNA physical 
units and logical units, cluster controllers, and termi¬ 
nals) attached through a communication adapter. 

channel link. A System/370 I/O channel to control unit 
interface that has an SNA network address. A channel 
link can be either a subarea link or a peripheral link. 
See also link and subarea link. 

character-coded. Synonym for unformatted . 

CICS. Customer Information Control System. 

CID. Communication identifier. 

CINIT. A network services request sent from a system 
services control point (SSCP) to a logical unit (LU) 
asking that LU to establish a session with another LU 
and to act as the primary end of the session. 

class of service (COS). In SNA, a designation of the 
path control network characteristics, such as path 
security, transmission priority, and bandwidth, that 
apply to a particular session. The end user designates 
class of service at session initiation by using a sym¬ 
bolic name that is mapped into a list of virtual routes, 
any one of which can be selected for the session to 
provide the requested level of service. 

cleanup. A network services request, sent by a system 
services control unit (SSCP) to a logical unit (LU), that 
causes a particular LU-LU session with that LU to be 
ended immediately and without the participation of 
either the other LU or its SSCP. 

clear data. Data that is not enciphered. Synonymous 
with plaintext. 

clear session. A session in which only clear data is 
transmitted or received. Contrast with cryptographic 
session. 

closedown. The deactivation of a device, program, or 
system. See cancel closedown , orderly closedown , 
and quick closedown. 

cluster controller. A device that can control the 
input/output operations of more than one device con¬ 
nected to it. A cluster controller may be controlled by a 
program stored and executed in the unit; for example, 
the IBM 3601 Finance Communication Controller. Or it 
may be controlled entirely by hardware; for example, 
the IBM 3272 Control Unit. 
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CMS. Conversational Monitor System. 

CNM. Communication network management. 

CNOS. Change number of sessions. 

code point. In the NetView/PC program and in the 
NetView program, a 1- or 2-byte hexadecimal value that 
indexes a text string stored at an alert receiver and is 
used by the alert receiver to create displays of alert 
information. 

command. (1) A request from a terminal for the per¬ 
formance of an operation or the execution of a partic¬ 
ular program. (2) In SNA, any field set in the 
transmission header (TH), request header (RH), and 
sometimes portions of a request unit (RU), that initiates 
an action or that begins a protocol; for example: (a) 
Bind Session (session-control request unit), a 
command that activates an LU-LU session, (b) the 
change-direction indicator in the RH of the last RU of a 
chain, (c) the virtual route reset window indicator in a 
FID4 transmission header. See also VTAM operator 
command, 

command facility. The component of the NetView 
program that is a base for command processors that 
can monitor, control, automate, and improve the opera¬ 
tion of a network. 

command list (CLIST). In the NetView program, a 
sequential list of commands and control statements 
that is assigned a name. When the name is invoked (as 
a command) the commands in the list are executed. 

command processor. A program that performs an 
operation specified by a command. 

communication adapter. An optional hardware feature, 
available on certain processors, that permits communi¬ 
cation lines to be attached to the processors. 

communication control unit. A communication device 
that controls the transmission of data over lines in a 
network. Communication control units include trans¬ 
mission control units (such as the 2702 Transmission 
Control Unit) and communication controllers (such as 
the 3720 or 3725). 

communication controller. A type of communication 
control unit whose operations are controlled by one or 
more programs stored and executed in the unit; for 
example, the IBM 3725 Communication Controller. It 
manages the details of line control and the routing of 
data through a network. 

communication identifier (CID). In VTAM, a key for 
locating the control blocks that represent a session. 

The key is created during the session-establishment 
procedure and deleted when the session ends. 


communication line. Deprecated term for telecommu¬ 
nication line and transmission line. 

communication management configuration (CMC). 

(1) In VTAM, a technique for configuring a network that 
allows for the consolidation of many network manage¬ 
ment functions for the entire network in a single host 
processor. (2) A multiple-domain network configura¬ 
tion in which one of the hosts, called the communi¬ 
cation management configuration host, performs most 
of the controlling functions for the network, thus 
allowing the other hosts, called data hosts, to process 
applications. This is accomplished by configuring the 
network so that the communication management host 
owns most of the resources in the network that are not 
application programs. The resources that are not 
owned by the communication management host are the 
resources that are channel-attached stations of data 
hosts. 

communication management configuration host node. 
The type 5 host processor in a communication manage¬ 
ment configuration that does all network-control func¬ 
tions in the network except for the control of devices 
channel-attached to data hosts. Synonymous with com¬ 
munication management host. Contrast with data host 
node. 

communication management host. Synonym for com¬ 
munication management configuration host node. Con¬ 
trast with data host 

communication network management (CNM). The 
process of designing, installing, operating, and man¬ 
aging the distribution of information and controls 
among end users of communication systems. 

communication network management (CNM) applica¬ 
tion program. A VTAM application program that issues 
and receives formatted management services request 
units for physical units. For example, NetView. 

communication network management (CNM) interface. 
The interface that the access method provides to an 
application program for handling data and commands 
associated with communication system management. 
CNM data and commands are handled across this inter¬ 
face. 

communication network management (CNM) processor. 
A program that manages one of the functions of a com¬ 
munications system. A CNM processor is executed 
under control of NetView. 

communication scanner processor (CSP). A processor 
in the 3725 Communication Controller that contains a 
microprocessor with control code. The code controls 
transmission of data over links attached to the CSP. 

composite end node (CEN). A group of nodes made up 
of a single type 5 node and its subordinate type 4 nodes 
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that together support type 2.1 protocols. To a type 2.1 
node, a CEN appears as one end node. For example, 
NCP and VTAM act as a composite end node. 

configuration. (1) (TC97) The arrangement of a com¬ 
puter system or network as defined by the nature, 
number, and the chief characteristics of its functional 
units. The term may refer to a hardware or a software 
configuration. (2) The devices and programs that 
make up a system, subsystem, or network. (3) In CCP, 
the arrangement of controllers, lines, and terminals 
attached to an IBM 3710 Network Controller. Also, the 
collective set of item definitions that describe such a 
configuration. 

configuration control program (CCP) facility. An SSP 

interactive application program facility by which config¬ 
uration definitions for the IBM 3710 Network Controller 
can be created, modified, and maintained. 

configuration services. In SNA, one of the types of 
network services in the control point (CP) and in the 
physical unit (PU); configuration services activate, 
deactivate, and maintain the status of physical units, 
links, and link stations. Configuration services also 
shut down and restart network elements and modify 
path control routing tables and address-translation 
tables. See also maintenance services , management 
services , network services , and session services. 

connected. In VTAM, pertaining to a physical unit (PU) 
or logical unit (LU) that has an active physical path to 
the host processor containing the system services 
control point (SSCP) that controls the PU or LU. 

connection. Synonym for physical connection. 

console communications services (CCS). The SNA 
facility that acts as an interface between the control 
program and the VSCS component of VTAM for VM. 

contention. A situation in which two logical units (LUs) 
that are connected by an LU 6.2 session both attempt to 
allocate the session for a conversation at the same 
time. The control operator assigns "winner” and 
“loser” status to the LUs so that processing may con¬ 
tinue on an orderly basis. The contention loser 
requests permission from the contention winner to allo¬ 
cate a conversation on the session, and the contention 
winner either grants or rejects the request. See also 
bidder. 

control block. (ISO) A storage area used by a computer 
program to hold control information. 

control operator. For logical unit (LU) 6.2, a service 
transaction program that describes and controls the 
availability of certain resources. For example, it 
describes network resources accessed by the local LU 


and it controls session limits between the LU and its 
partners. See also contention. 

control point (CP). (1) A system services control point 
(SSCP) that provides hierarchical control of a group of 
nodes in a network. (2) A control point (CP) local to a 
specific node that provides control of that node, either 
in the absence of SSCP control (for type 2.1 nodes 
engaged in peer to peer communication) or to supple¬ 
ment SSCP control. 

control program (CP). The VM operating system that 
manages the real processor's resources and is respon¬ 
sible for simulating System/370s for individual users. 

controlling application program. In VTAM, an applica¬ 
tion program with which a secondary logical unit (other 
than an application program) is automatically put in 
session whenever the secondary logical unit is avail¬ 
able. See also automatic iogon and controliing logical 
unit. 

controlling logical unit. In VTAM, a logical unit with 
which a secondary logical unit (other than an applica¬ 
tion program) is automatically put in session whenever 
the secondary logical unit is available. A controlling 
logical unit can be either an application program or a 
device-type logical unit. See also automatic iogon and 
controliing application program. 

control statement. A statement in a command list that 
controls the processing sequence of the command list 
or allows the command list to send messages to the 
operator and receive input from the operator. 

conversation. In SNA, a logical connection between 
two transaction programs using an LU 6.2 session. 
Conversations are delimited by brackets to gain exclu¬ 
sive use of a session. 

Conversational Monitor System (CMS). A VM applica¬ 
tion program for general interactive time sharing, 
problem solving, and program development. 

converted command. An intermediate form of a 
character-coded command produced by VTAM through 
use of an unformatted system services definition table. 
The format of a converted command is fixed; the unfor¬ 
matted system services definition table must be con¬ 
structed in such a manner that the character-coded 
command (as entered by a logical unit) is converted 
into the predefined, converted command format. See 
also unformatted. 

COS. Class of service. 

coupler. A hardware device that connects a modem to 
a public phone system in much the same way that a 
telephone does. 

CP. (1) Control program. (2) Control point. 
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cross-domain. In SNA, pertaining to control of 
resources involving more than one domain. 

cross-domain resource (CDRSC). A resource owned by 
a cross-domain resource manager (CDRM) in another 
domain but known by the CDRM in this domain by 
network name and associated CDRM. 

cross-domain resource manager (CDRM). In VTAM, 
the function in the system services control point (SSCP) 
that controls initiation and termination of cross-domain 
sessions. 

cross-network. In SNA, pertaining to control or 
resources involving more than one SNA network. 

cross-network LU-LU session. In SNA, a session 
between logical units (LUs) in different networks. 

cross-network session. An LU-LU or SSCP-SSCP 
session whose path traverses more than one SNA 
network. 

CRV. Cryptography verification. 

cryptographic. Pertaining to the transformation of data 
to conceal its meaning. See also encipher and deci¬ 
pher. 

cryptographic session. In SNA products, an LU-LU 
session in which a function management data (FMD) 
request may be enciphered before it is transmitted and 
deciphered after it is received. Contrast with clear 
session. See required cryptographic session and 
selective cryptographic session. 

cryptographic session key. In SNA, deprecated term 
for session cryptography key. 

cryptography verification (CRV) request. A request unit 
sent by the primary logical unit (PLU) to the secondary 
logical unit (SLU) as part of cryptographic session 
establishment, to allow the SLU to verify that the PLU is 
using the correct cryptographic session key. 

CSP. Communication scanner processor. 

Customer Information Control System (CICS). A 
licensed program that enables transactions entered at 
remote terminals to be processed concurrently by user- 
written application programs. It also includes facilities 
for building, using, and maintaining data bases. 

DAF. Destination address field. 

data channel. Synonym for input/output channel. See 
channel. 

data check. An indication that a transmission is faulty. 
For example, in SDLC a frame check sequence (FCS) 
error. 


data circuit-terminating equipment (DCE). (TC97) The 
equipment installed at the user's premises that pro¬ 
vides all functions required to establish, maintain, and 
terminate a connection, and the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. The DCE may be separate equipment or an 
integral part of other equipment. 

data-encrypting key. A key used to encipher and deci¬ 
pher data transmitted in a cryptographic session. Con¬ 
trast with key-encrypting key. See session 
cryptography key. 

data flow control (DFC). In SNA, a request/response 
unit (RU) category used for requests and responses 
exchanged between the data flow control layer in one 
half-session and the data flow control layer in the 
session partner. 

data flow control (DFC) layer. In SNA, the layer within 
a half-session that (1) controls whether the half-session 
can send, receive, or concurrently send and receive 
request units (RUs); (2) groups related RUs into RU 
chains; (3) delimits transactions via the bracket pro¬ 
tocol; (4) controls the interlocking of requests and 
responses in accordance with control modes specified 
at session activation; (5) generates sequence numbers; 
and (6) correlates requests and responses. 

data flow control (DFC) protocol. In SNA, the 
sequencing rules for requests and responses by which 
network addressable units (NAUs) in a session coordi¬ 
nate and control data transfer and other operations. 

For example, see bracket protocol. 

data host. Synonym for data host node. Contrast with 
communication management configuration host. 

data host node. In a communication management con¬ 
figuration, a type 5 host node that is dedicated to proc¬ 
essing applications and does not control network 
resources, except for its channel-attached or communi¬ 
cation adapter-attached devices. Synonymous with 
data host. Contrast with communication management 
configuration host node. 

data link. In SNA, synonym for link. 

data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a transmission medium connecting two nodes and 
perform error control for the link connection. Examples 
of data link control are SDLC for serial-by-bit link con¬ 
nection and data link control for the System/370 
channel. 

data link control protocol. In SNA, a set of rules used 
by two nodes on a data link to accomplish an orderly 
exchange of information. Synonymous with line 
control. 
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data terminal equipment (DTE). (TC97) That part of a 
data station that serves as a data source, data link, or 
both, and provides for the data communication control 
function according to protocols. 

data types. In the NetView program, a concept to 
describe the organization of panels. Data types are 
defined as alerts, events, and statistics. Data types are 
combined with resource types and display types to 
describe NetView's display organization. See also 
display types and resource types. 

DBCS. Double-byte character set. 

DCE. Data circuit-terminating equipment. 

deactivate. To take a resource of a node out of service, 
rendering it inoperable, or to place it in a state in which 
it cannot perform the functions for which it was 
designed. Contrast with activate . 

deallocate. A logical unit (LU) 6.2 application program 
interface (API) verb that terminates a conversation, 
thereby freeing the session for a future conversation. 
Contrast with allocate . 

decipher. To convert enciphered data into clear data. 
Contrast with encipher . Synonymous with decrypt 

decrypt. To convert encrypted data into clear data. 
Contrast with encrypt. Synonym for decipher. 

decryption. The unscrambling of data using an algo¬ 
rithm which works under the control of a key. The key 
allows data to be protected even when the algorithm is 
unknown. Data is unscrambled after transmission. 
Contrast with encryption. 

definite response (DR). In SNA, a value in the form-of- 
response-requested field of the request header. The 
value directs the receiver of the request to return a 
response unconditionally, whether positive or negative, 
to that request. Contrast with exception response and 
no response. 

definition statement. (1) In VTAM, the statement that 
describes an element of the network. (2) In NCP, a 
type of instruction that defines a resource to the NCP. 
See Figure 182, Figure 183, and Figure 184. See also 
macroinstruction . 
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Figure 184. VTAM Examples 

definition statement identifier. A specific character 
string that identifies the purpose of a definition state¬ 
ment. 

dependent LU. Any logical unit (LU) that receives an 
ACTLU over a link. Such LUs can act only as sec¬ 
ondary logical units (SLUs) and can have only one 
LU-LU session at a time. Contrast with independent 
LU. 


destination address field (DAF). In SNA, a field in a 
FIDO or FID1 transmission header that contains the 
network address of the destination. 
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destination logical unit (DLU). The logical unit to which 
data is to be sent. Contrast with origin logical unit 
(OLU). 

device-type logical unit, in VTAM, a logical unit that 
has a session limit of 1 and usually acts as the sec¬ 
ondary end of a session. It is typically a logical unit 
(LU) in an SNA terminal, such as a 3270. It could be the 
primary end of a session, for example, the logical unit 
representing the Network Routing Facility (NRF) logical 
unit. 

DFC. Data flow control. 

dial-in. Refers to the direction in which a switched con¬ 
nection is requested by any node or terminal other than 
the receiving host or an NCP. 

dial-out. Refers to the direction in which a switched 
connection is requested by a host or an NCP. 

directory. In VM, a control program (CP) disk that 
defines each virtual machine’s normal configuration. 

disabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is temporarily not ready to establish 
LU-LU sessions. An initiate request for a session with 
a disabled logical unit (LU) can specify that the session 
be queued by the SSCP until the LU becomes enabled. 
The LU can separately indicate whether this applies to 
its ability to act as a primary logical unit (PLU) or a sec¬ 
ondary logical unit (SLU). See also enabled and inhib¬ 
ited. 

disconnection. The termination of a physical con¬ 
nection. 

display. (1) To present information for viewing, usually 
on a terminal screen or a hard-copy device. (2) A 
device or medium on which information is presented, 
such as a terminal screen. (3) Deprecated term for 
panel. 

display levels. Synonym for display types. 

display types. In NetView, a concept to describe the 
organization of panels. Display types are defined as 
total, most recent, user action, and detail. Display 
types are combined with resource types and data types 
to describe NetView's panel organization. See data 
types and resource types. Synonymous with display 
levels. 

DLC. Data link control. 

DLU. Destination logical unit. 

domain. (1) An access method, its application pro¬ 
grams, communication controllers, connecting lines, 
modems, and attached terminals. (2) In SNA, a system 


services control point (SSCP) and the physical units 
(PUs), logical units (LUs), links, link stations, and all the 
associated resources that the SSCP has the ability to 
control by means of activation requests and deacti¬ 
vation requests. See system services control point 
domain and type 2.1 node control point domain. See 
also single-domain network and multiple-domain 
network 

domain operator. In a multiple-domain network, the 
person or program that controls the operation of the 
resources controlled by one system services control 
point. Contrast with network operator (2). 

double-byte character set (DBCS). A set of graphic 
characters where two bytes are used to represent the 
character set of such languages as Chinese and 
Japanese. The shift-in (SI) and shift-out (SO) control 
codes are used when DBCS is mixed with standard 
one-byte character sets. 

downstream. In the direction of data flow from the host 
to the end user. Contrast with upstream. 

downstream device. For the IBM 3710 Network Con¬ 
troller, a device located in a network such that the 3710 
is positioned between the device and a host. A display 
terminal downstream from the 3710 is an example of a 
downstream device. Contrast with upstream device. 

downstream line. For the IBM 3710 Network Controller, 
a telecommunication line attaching a downstream 
device to a 3710. Contrast with upstream line. 

Downstream Load Utility (DSLU). A licensed program 
that uses the communication network management 
(CNM) interface to support the load requirements of 
certain type 2 physical units, such as the IBM 3644 
Automatic Data Unit and the IBM 8775 Display Ter¬ 
minal. 

DR. (1) In NCP and CCP, dynamic reconfiguration. 

(2) In SNA, definite response. 

DRDS. Dynamic reconfiguration data set. 

DTE. Data terminal equipment. 

dump. (1) Computer printout of storage. (2) To write 
the contents of all or part of storage to an external 
medium as a safeguard against errors or in connection 
with debugging. (3) (ISO) Data that have been dumped. 

duplex. * In data communication, pertaining to a simul¬ 
taneous two-way independent transmission in both 
directions. Synonymous with full duplex. Contrast with 
half duplex. 

dynamic reconfiguration (DR). The process of changing 
the network configuration (peripheral PUs and LUs) 
without regenerating complete configuration tables. 
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dynamic reconfiguration data set (DRDS). In VTAM, a 
data set used for storing definition data that can be 
applied to a generated communication controller con¬ 
figuration at the operator’s request. A dynamic recon¬ 
figuration data set can be used to dynamically add PUs 
and LUs, delete PUs and LUs, and move PUs. It is acti¬ 
vated with the VARY DRDS operator command. See 
also dynamic reconfiguration. 

EBCDIC. * Extended binary-coded decimal interchange 
code. A coded character set consisting of 8-bit coded 
characters. 

ECB. Event control block. 

echo. The return of characters to the originating SS 
device to verify that a message was sent correctly. 

echo check. A check to determine the correctness of 
the transmission of data in which the received data are 
returned to the source for comparison with the ori¬ 
ginally transmitted data. 

ED. Enciphered data. 

EIA. Electronic Industries Association. Provides inter¬ 
face standards for electrical and electronic equipment. 

element. (1) A field in the network address. (2) The 
particular resource within a subarea identified by the 
element address. See also subarea. 

element address. In SNA, a value in the element 
address field of the network address identifying a spe¬ 
cific resource within a subarea. See subarea address. 

emulation mode. The function of a network control 
program that enables it to perform activities equivalent 
to those performed by a transmission control unit. 
Contrast with network control mode. 

Emulation Program (EP). An IBM control program that 
allows a channel-attached 3705 or 3725 communication 
controller to emulate the functions of an IBM 2701 Data 
Adapter Unit, an IBM 2702 Transmission Control, or an 
IBM 2703 Transmission Control. See also network 
control program. 

enabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is now ready to establish LU-LU sessions. 
The LU can separately indicate whether this prevents it 
from acting as a primary logical unit (PLU) or as a sec¬ 
ondary logical unit (SLU). See also disabled and inhib¬ 
ited. 

encipher. (1) To scramble data or convert it, before 
transmission, to a secret code that masks the meaning 
of the data to any unauthorized recipient. (2) In VTAM, 
to convert clear data into enciphered data. Contrast 
with decipher. Synonymous with encrypt 

MO V/TAM nismnn«is 


enciphered data (ED). Data whose meaning is con¬ 
cealed from unauthorized users. 

encrypt. Synonym for encipher. 

encryption. The scrambling or encoding of data using 
an algorithm which works under the control of a key. 
The key allows data to be protected even when the 
algorithm is unknown. Data is scrambled prior to 
transmission. Contrast with decryption. 

end bracket. In SNA, the value (binary 1) of the end 
bracket indicator in the request header (RH) of the first 
request of the last chain of a bracket; the value denotes 
the end of the bracket. Contrast with begin bracket. 

See also bracket. 

end-of-transmission (EOT). The specific character, or 
sequence of characters, that indicates no more data. 

end-of-transmission (EOT) handshaking. When a 3710 
sends EOT characters over an idle line and waits for 
return characters. If no EOT response is returned, the 
3710 breaks the session. 

end node. A type 2.1 node that does not provide any 
intermediate routing or session services to any other 
node. For example, APPC/PC is an end node. See 
composite end node, node , and type 2.1 node. 

end user. In SNA, the ultimate source or destination of 
application data flowing through an SNA network. An 
end user may be an application program or a terminal 
operator. 

entry point. An SNA node that provides distributed 
network management support. It may be a type 2, type 
2.1, type 4, or type 5 node. It sends SNA-formatted 
network management data about itself and the 
resources it controls to a focal point for centralized 
processing, and it receives and executes focal point ini¬ 
tiated commands to manage and control its resources. 

EOT. End-of-transmission. 

EP. Emulation Program. 

ER. (1) Explicit route. (2) Exception response. 

error-to-traffic (E/T). The number of temporary errors 
compared to the traffic associated with a resource. 

E/T. Error-to-traffic. 

event. (1) In the NetView program, a record indicating 
irregularities of operation in physical elements of a 
network. (2) An occurrence of significance to a task; 
typically, the completion of an asynchronous operation, 
such as an input/output operation. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 



“Restricted Materials of IBM" 

Licensed Materials - Property of IBM 


event control block (ECB). A control block used to rep¬ 
resent the status of an event. 

exception request (EXR). In SNA, a request that 
replaces another message unit in which an error has 
been detected. 

exception response (ER). In SNA, a value in the form- 
of-response-requested field of a request header (RH). 
An exception response is sent only if a request is unac¬ 
ceptable as received or cannot be processed. Contrast 
with definite response and no response. See also neg¬ 
ative response. 

exchange identification (XID). A data link control 
command and response passed between adjacent 
nodes that allows the two nodes to exchange identifica¬ 
tion and other information necessary for operation over 
the data link. 

EXEC. In a VM operating system, a user-written 
command file that contains CMS commands, other 
user-written commands, and execution control state¬ 
ments, such as branches. 

exit list (EXLST). In VS AM and VTAM, a control block 
that contains the addresses of routines that receive 
control when specified events occur during execution; 
for example, routines that handle session- 
establishment request processing or I/O errors. 

exit routine. Any of several types of special-purpose 
user-written routines. See accounting exit routine, 
authorization exit routine, logon-interpret routine, 
virtual route selection exit routine, EXLST exit routine , 
and RPL exit routine. 

EXLST exit routine. In VTAM, a routine whose address 
has been placed in an exit list (EXLST) control block. 
The addresses are placed there with the EXLST macro¬ 
instruction, and the routines are named according to 
their corresponding operand; hence DFASY exit 
routine, TPEND exit routine, RELREQ exit routine, and 
so forth. All exit list routines are coded by the VTAM 
application programmer. Contrast with RPL exit 
routine. 

expedited flow. In SNA, a data flow designated in the 
transmission header (TH) that is used to carry network 
control, session control, and various data flow control 
request/response units (RUs); the expedited flow is 
separate from the normal flow (which carries primarily 
end-user data) and can be used for commands that 
affect the normal flow. Contrast with normal flow. 

explicit command. In the NetView program, using a 
direct command to start an operation or to request 
information instead of stepping through the panel hier¬ 
archy to do so. 


explicit route (ER). In SNA, the path control network 
elements, including a specific set of one or more trans¬ 
mission groups, that connect two subarea nodes. An 
explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). See also path and 
route extension . 

explicit route length. In SNA, the number of trans¬ 
mission groups in an explicit route. 

EXR. Exception request. 

extended recovery facility (XRF). Software designed to 
minimize the effect of failures in MVS, VTAM, the host 
processor, or IMS/VS on sessions between IMS/VS and 
designated terminals. It provides an alternate sub¬ 
system to take over failing sessions. 

FDX. Full duplex. 

feature. A particular part of an IBM product that a cus¬ 
tomer can order separately. 

FIC. First-in-chain. 

FID. Format identification. 

field-formatted. Pertaining to a request or response 
that is encoded into fields, each having a specified 
format such as binary codes, bit-significant flags, and 
symbolic names. Contrast with character-coded. 

field-formatted request. In SNA, a request that is 
encoded into fields, each having a specified format 
such as binary codes, binary counts, bit-significant 
flags, and symbolic names; a format indicator in the 
request/response header (RH) for the request is set to 
zero. Contrast with character-coded. 

first-in-chain (FIC). A request unit (RU) whose request 
header (RH) begin chain indicator is on and whose RH 
end chain indicator is off. See also RU chain. 

first speaker. In SNA, the LU-LU half-session defined at 
session activation as: (1) able to begin a bracket 
without requesting permission from the other LU-LU 
half-session to do so, and (2) winning contention if both 
half-sessions attempt to begin a bracket simultane¬ 
ously. Contrast with bidder. See also bracket protocol. 

flow control. In SNA, the process of managing the rate 
at which data traffic passes between components of the 
network. The purpose of flow control is to optimize the 
rate of flow of message units, with minimum congestion 
in the network; that is, to neither overflow the buffers at 
the receiver or at intermediate routing nodes, nor leave 
the receiver waiting for more message units. See also 
adaptive session-level pacing , pacing, session-level 
pacing , and virtual route pacing. 
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FMD. Function management data. 

FMH. Function management header. 

focal point. An entry point that provides centralized 
management and control for other entry points for one 
or more network management categories. 

format identification (FID) field. In SNA, a field in each 
transmission header (TH) that indicates the format of 
the TH; that is, the presence or absence of certain 
fields. TH formats differ in accordance with the types of 
nodes between which they pass. The six FID types are: 

FIDO, used for traffic involving non-SNA devices 
between adjacent subarea nodes when either or 
both nodes do not support explicit route and virtual 
route protocols. 

FID1, used for traffic between adjacent subarea 
nodes when either or both nodes do not support 
explicit route and virtual route protocols. 

FID2, used for traffic between a subarea node and 
an adjacent type 2 peripheral node. 

FID3, used for traffic between a subarea node and 
an adjacent type 1 peripheral node. 

FID4, used for traffic between adjacent subarea 
nodes when both nodes support explicit route and 
virtual route protocols. 

FIDF, used for certain commands (for example, for 
transmission group control) sent between adjacent 
subarea nodes when both nodes support explicit 
route and virtual route protocols. 

formatted system services. A portion of VTAM that pro¬ 
vides certain system services as a result of receiving a 
field-formatted command, such as an Initiate or Termi¬ 
nate command. Contrast with unformatted system ser¬ 
vices (USS). See also field-formatted. 

frame. (1) The unit of transmission in some local area 
networks, including the IBM Token-Ring Network. It 
includes delimiters, control characters, information, 
and checking characters. (2) In SDLC, the vehicle for 
every command, every response, and all information 
that is transmitted using SDLC procedures. 

full duplex (FDX). Synonym for duplex. 

full-screen mode. A form of panel presentation in 
NetView where the contents of an entire terminal 
screen can be displayed at once. Full-screen mode can 
be used for fill-in-the-blanks prompting. Contrast with 
line mode. 

function management data (FMD). In SNA, a request 
unit (RU) category used for end-user data exchanged 
between logical units (LUs) and for requests and 
responses exchanged between network services com¬ 


ponents of LUs, physical units (PUs), and system ser¬ 
vices control points (SSCPs). 

function management header (FMH). In SNA, one or 
more headers, optionally present in the leading request 
units (RUs) of an RU chain, that allow one half-session 
in an LU-LU session to: (1) select a destination at the 
session partner and control the way in which the end- 
user data it sends is handled at the destination, (2) 
change the destination or the characteristics of the data 
during the session, and (3) transmit between session 
partners status or user information about the destina¬ 
tion (for example, a program or device). Function man¬ 
agement headers (FMHs) can be used on LU-LU types 
1,4, and 6.2. 

gateway. The combination of machines and programs 
that provide address translation, name translation, and 
system services control point (SSCP) rerouting 
between independent SNA networks to allow those net¬ 
works to communicate. A gateway consists of one 
gateway NCP and at least one gateway SSCP. 

gateway NCP. An NCP that performs address trans¬ 
lation to allow cross-network session traffic. The 
gateway NCP connects two or more independent SNA 
networks. Synonymous with gateway node. 

gateway node. Synonym for gateway NCP. 

gateway SSCP. An SSCP that is capable of cross¬ 
network session initiation, termination, takedown, and 
session outage notification. A gateway SSCP is in 
session with the gateway NCP; it provides network 
name translation and assists the gateway NCP in 
setting up alias network addresses for cross-network 
sessions. 

GCS. Group control system. 

generalized path information unit trace (GPT). A record 
of the flow of path information units (PIUs) exchanged 
between the network control program and its attached 
resources. PIU trace records consist of up to 44 bytes 
of transmission header (TH), request/response header 
(RH), and request/response unit (RU) data. 

generation. The process of assembling and link editing 
definition statements so that resources can be identi¬ 
fied to all the necessary programs in a network. 

generic unbind. Synonym for session deactivation 
request. 

GPT. Generalized path information unit trace. 

group. In the NetView/PC program, to identify a set of 
application programs that are to run concurrently. 

group control system (GCS). A component of VM that 
provides multi-programming and shared memory 
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support to virtual machines. It is a saved system 
intended for use with SNA products. 

half-duplex. * In data communication, pertaining to an 
alternate, one way at a time, independent transmission. 
Contrast with duplex. 

half-session. In SNA, a component that provides func¬ 
tion management data (FMD) services, data flow 
control, and transmission control for one of the ses¬ 
sions of a network addressable unit (NAU). See also 
primary half-session and secondary half-session. 

hard copy. A printed copy of machine output in a visu¬ 
ally readable form; for example, printed reports, 
listings, documents, summaries, or network logs. 

hardware monitor. The component of the NetView 
program that helps identify network problems, such as 
hardware, software, and microcode, from a central 
control point using interactive display techniques. 

help panel. An online display that tells you how to use 
a command or another aspect of a product. See task 
panel. 

High Performance Option (HPO). A licensed program 
that is an extension of VM/SP. It provides performance 
and operation enhancements for large system environ¬ 
ments. 

hierarchy. In the NetView program, the resource types, 
display types, and data types that make up the organ¬ 
ization, or levels, in a network. 

host node. A node providing an application program 
interface (API) and a common application interface. 

See boundary node, node, peripheral node, subarea 
host node , and subarea node. See also boundary func¬ 
tion and node type. 

host processor. (1) (TC97) A processor that controls 
all or part of a user application network. (2) In a 
network, the processing unit in which the data commu¬ 
nication access method resides. 

HPO. High Performance Option. 

hung terminal. A terminal to which a session is dis¬ 
rupted and that cannot send or receive commands. 

l-frame. A DLC frame type for transmitting data. Other 
DLC frame types are for control, status, and supervi¬ 
sory information. 

IMR. Intensive mode recording. 

IMS. Information Management System/Virtual Storage. 
Synonymous with IMS/VS. 


IMS/VS. Information Management System/Virtual 
Storage. Synonym for IMS. 

inactive. Describes the state of a resource that has not 
been activated or for which the VARY INACT command 
has been issued. Contrast with active. See also inop¬ 
erative. 

independent LU. A logical unit (LU) that does not 
receive an ACTLU over a link. Such LUs can act as 
primary logical units (PLUs) or secondary logical units 
(SLUs) and can have one or more LU-LU sessions at a 
time. Contrast with dependent LU. 

Information/Management. A feature of the 
Information/System licensed program that provides 
interactive systems management applications for 
problem, change, and configuration management 

Information Management System (IMS). A general 
purpose system whose full name is Information Man¬ 
agement System/Virtual Storage (IMS/VS). It enhances 
the capabilities of OS/VS for batch processing and tele¬ 
communication and allows users to access a computer- 
maintained data base through remote terminals. 

Information/System. An interactive retrieval program 
with related utilities designed to provide systems pro¬ 
grammers with keyword access to selected technical 
information contained in either of its companion pro¬ 
ducts, Information/MVS or Information/VM-VSE. 

inhibited. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is not ready to establish LU-LU sessions. 
An initiate request for a session with an inhibited LU 
will be rejected by the SSCP. The LU can separately 
indicate whether this applies to its ability to act as a 
primary logical unit (PLU) or as a secondary logical 
unit (SLU). See also enabled and disabled. 

initiate. A network services request sent from a logical 
unit (LU) to a system services control point (SSCP) 
requesting that an LU-LU session be established. 

inoperative. The condition of a resource that has been 
active, but is not. The resource may have failed, 
received an INOP request, or is suspended while a 
reactivate command is being processed. See also 
inactive. 

input/output channel. (1) (ISO). In a data processing 
system, a functional unit that handles the transfer of 
data between internal and peripheral equipment. (2) In 
a computing system, a functional unit, controlled by a 
processor, that handles the transfer of data between 
processor storage and local peripheral devices. Syn¬ 
onymous with data channel. See channel. See also 
link. 
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installation exit routine. In VTAM, a user-written exit 
routine that can perform functions related to initiation 
and termination of sessions and is run as part of VTAM 
rather than as part of an application program. Exam¬ 
ples are the accounting, authorization, logon-interpret, 
and virtual route selection exit routines. Contrast with 
application program exit routine. 

intensive mode recording (IMR). An NCP function that 
forces recording of temporary errors for a specified 
resource. 

interactive problem control system (IPCS). A VM 
facility for diagnosing problems, and managing 
problem information and status. IPCS is the principal 
means for diagnosing virtual machine dumps. 

interconnection. See SNA network interconnection . 

interface. * A shared boundary. An interface might be 
a hardware component to link two devices or it might 
be a portion of storage or registers accessed by two or 
more computer programs. 

intermediate routing function (IRF). In SNA, a path 
control capability in a subarea node that receives and 
routes path information units (PIUs) that neither origi¬ 
nate in nor are destined for network addressable units 
(NAUs) in the subarea. See also boundary function. 

intermediate routing node (IRN). In SNA, a subarea 
node with intermediate routing function. 

interpret table. In VTAM, an installation-defined corre¬ 
lation list that translates an argument into a string of 
eight characters. Interpret tables can be used to trans¬ 
late logon data into the name of an application program 
for which the logon is intended. 

inter-user communication vehicle (IUCV). A VM facility 
for passing data between virtual machines and VM 
components. 

IPCS. Interactive problem control system. 

IRN. Intermediate routing node. 

item. In CCP, any of the components, such as commu¬ 
nication controllers, lines, cluster controllers, and ter¬ 
minals, that comprise an IBM 3710 Network Controller 
configuration. 

IUCV. Inter-user communication vehicle. 

JCL. Job control language. 

fob control language (JCL). * A problem-oriented lan¬ 
guage designed to express statements in a job that are 
used to identify the job or describe its requirements to 
an operating system. 


Kanji. A character set of symbols used for Japanese 
ideograms. See also double-byte character set. 

key-encrypting key. A key used in sessions with 
cryptography to encipher and decipher other keys. 
Contrast with data-encrypting key. 

keyword. (1) (TC97) A lexical unit that, in certain con¬ 
texts, characterizes some language construction. (2) * 
One of the predefined words of an artificial language. 

(3) One of the significant and informative words in a 
title or document that describes the content of that doc¬ 
ument. (4) A name or symbol that identifies a param¬ 
eter. (5) A part of a command operand that consists of 
a specific character string (such as DSNAME = ). See 
also definition statement and keyword operand. Con¬ 
trast with positional operand. 

keyword operand. An operand that consists of a 
keyword followed by one or more values (such as 
DSNAME = HELLO). See also definition statement. 
Contrast with positional operand. 

keyword parameter. (1) A parameter that consists of a 
keyword followed by one or more values. 

large message performance enhancement outbound 
(LMPEO). In VTAM, a facility in which VTAM reformats 
function management data (FMD) that exceed the 
maximum request unit (RU) size (as specified in the 
BIND) into a chain or partial chain of RUs. 

last-in-chain (LIC). A request unit (RU) whose request 
header (RH) end chain indicator is on and whose RH 
begin chain indicator is off. See also RU chain. 

LIC. (1) Last-in-chain. (2) In NCP, line interface card. 

line. See communication line. 

line mode. A form of screen presentation in which the 
information is presented a line at a time in the message 
area of the terminal screen. Contrast with full-screen 
mode. 

line control. Synonym for data link control protocol. 

line group. One or more telecommunication lines of 
the same type that can be activated and deactivated as 
a unit. 

link. In SNA, the combination of the link connection and 
the link stations joining network nodes; for example: 

(1) a System/370 channel and its associated protocols, 

(2) a serial-by-bit connection under the control of Syn¬ 
chronous Data Link Control (SDLC). A link connection 
is the physical medium of transmission. A link, 
however, is both logical and physical. Synonymous 
with data link. See Figure 185 on page 697. 
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Subarea Host Node 



Figure 185. Links and Path Controls 

link connection. In SNA, the physical equipment pro¬ 
viding two-way communication between one link station 
and one or more other link stations; for example, a tele¬ 
communication line and data circuit terminating equip¬ 
ment (DCE). 


link connection segment. A portion of the configuration 
that is located between two resources listed consec¬ 
utively in the service point command service (SPCS) 
query link configuration request list. 

link level 2 test. See link test. 
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link station. (1) In SNA, the combination of hardware 
and software that allows a node to attach to and 
provide control for a link. (2) In VTAM, a named 
resource within a subarea node that represents 
another subarea node that is attached by a subarea 
link. In the resource hierarchy, the link station is sub¬ 
ordinate to the subarea link. 

link test. In SNA, a test in which one link station 
returns data received from another link station without 
changing the data in order to test the operation of the 
link. Three tests can be made; they differ in the 
resources that are dedicated during the test. 

LMPEO. Large message performance enhancement 
outbound. 

load module. (ISO) A program unit that is suitable for 
loading into main storage for execution; it is usually the 
output of a linkage editor. 

local address. In SNA, an address used in a peripheral 
node in place of an SNA network address and trans¬ 
formed to or from an SNA network address by the 
boundary function in a subarea node. 

local area network (LAN). (1) A network in which a set 
of devices are connected to one another for communi¬ 
cation and that can be connected to a larger network. 
See also token ring. (2) A network in which communi¬ 
cations are limited to a moderately sized geographic 
area such as a single office building, warehouse, or 
campus, and which do not generally extend across 
public rights-of-way. Contrast with wide area network. 

local session Identification (LSID). In SNA, a field in a 
FID3 (format identification type 3) transmission header 
that contains an indication of the type of session 
(SSCP-PU, SSCP-LU, or LU-LU) and the local address of 
the peripheral logical unit (LU) or physical unit (PU). 

logic error. In VTAM, an error condition that results 
from an invalid request; a program logic error. 

logical record. (1) (TC 97) A set of related data or 
words considered to be a record from a logical view¬ 
point. (2) A unit of information normally pertaining to a 
single subject; a logical record is that user record 
requested of or given to the data management function. 
See also basic conversation. 

logical unit (LU). In SNA, a port through which an end 
user accesses the SNA network and the functions pro¬ 
vided by system services control points (SSCPs). An 
LU can support at least two sessions—one with an 
SSCP and one with another LU—and may be capable of 
supporting many sessions with other LUs. See also 
network addressable unit (NAU), peripheral LU, phys¬ 
ical unit (PU), system services control point (SSCP), 


primary logical unit (PLU), and secondary logical unit 
(SLU). 

logical unit (LU) services. In SNA, capabilities in a 
logical unit to: (1) receive requests from an end user 
and, in turn, issue requests to the system services 
control point (SSCP) in order to perform the requested 
functions, typically for session initiation; (2) receive 
requests from the SSCP, for example to activate LU-LU 
sessions via Bind Session requests; and (3) provide 
session presentation and other services for LU-LU ses¬ 
sions. See also physical unit (PU) services. 

logical unit (LU) 6.2. A type of logical unit that supports 
general communication between programs in a distrib¬ 
uted processing environment. LU 6.2 is characterized 
by (1) a peer relationship between session partners, (2) 
efficient utilization of a session for multiple trans¬ 
actions, (3) comprehensive end-to-end error proc¬ 
essing, and (4) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 

logmode table. Synonym for logon mode table. 

log oft. To request that a session be terminated. 

logoff. In VTAM, an unformatted session termination 
request. 

log on. To initiate a session. 

logon. In VTAM, an unformatted session initiation 
request for a session between two logical units. See 
automatic logon and simulated logon. See also 
session-initiation request. 

logon data. In VTAM: (1) The user data portion of a 
field-formatted or unformatted session-initiation 
request. (2) The entire logon sequence or message 
from a logical unit (LU). Synonymous with logon 
message. 

logon message. Synonym for logon data. 

logon mode. In VTAM, a subset of session parameters 
specified in a logon mode table for communication with 
a logical unit. See also session parameters. 

logon mode table. In VTAM, a set of entries for one or 
more logon modes. Each logon mode is identified by a 
logon mode name. Synonymous with logmode table. 

logon-interpret routine. In VTAM, an installation exit 
routine, associated with an interpret table entry, that 
translates logon information. It may also verify the 
logon. 

LSID. Local session identification. 

LU. Logical unit. 


698 VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984,1989 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


LU 6.2 session. A session that is initiated by VTAM on 
behalf of a logical unit (LU) 6.2 application program, or 
a session initiated by a remote LU in which the applica¬ 
tion program specifies that VTAM is to control the 
session by using the APPCCMD macroinstruction. 

LU type. In SNA, the classification of an LU-LU session 
in terms of the specific subset of SNA protocols and 
options supported by the logical units (LUs) for that 
session, namely: 

The mandatory and optional values allowed in the 
session activation request. 

The usage of data stream controls, function man¬ 
agement headers (FMHs), request unit (RU) param¬ 
eters, and sense codes. 

Presentation services protocols such as those 
associated with FMH usage. 

LU types 0, 1, 2, 3, 4, 6.1,6.2, and 7 are defined. 

LU-LU session. In SNA, a session between two logical 
units (LUs) in an SNA network. It provides communi¬ 
cation between two end users, or between an end user 
and an LU services component. 

LU-LU session type. A deprecated term for LU type . 

LU 6.2. Logical unit 6.2. 

macroinstruction. (1) An instruction that when exe¬ 
cuted causes the execution of a predefined sequence of 
instructions in the same source language. (2) In 
assembler programming, an assembler language state¬ 
ment that causes the assembler to process a prede¬ 
fined set of statements called a macro definition. The 
statements normally produced from the macro defi¬ 
nition replace the macroinstruction in the program. 

See also definition statement. 

maintain system history program (MSHP). A program 
that facilitates the process of installing and servicing a 
VSE system. 

maintenance and operator subsystem (MOSS). A sub¬ 
system of an IBM communication controller, such as 
the 3725 or the 3720, that contains a processor and 
operates independently of the rest of the controller. It 
loads and supervises the controller, runs problem 
determination procedures, and assists in maintaining 
both hardware and software. 

maintenance services. In SNA, one of the types of 
network services in system services control points 
(SSCPs) and physical units (PUs). Maintenance ser¬ 
vices provide facilities for testing links and nodes and 
for collecting and recording error information. See 
also configuration services, management services, 
network services , and session services. 


major node. In VTAM, a set of resources that can be 
activated and deactivated as a group. See node and 
minor node. 

management services. In SNA, one of the types of 
network services in control points (CPs) and physical 
units (PUs). Management services are the services 
provided to assist in the management of SNA networks, 
such as problem management, performance and 
accounting management, configuration management 
and change management. See also configuration ser¬ 
vices, maintenance services, network services, and 
session services . 

mandatory cryptographic session. Synonym for 
required cryptographic session. 

mapped conversation. A type of conversation in which 
the data to be sent or received can be in a user-defined 
format. A logical unit (LU) that supports mapped con¬ 
versations converts the user data to a format suitable 
for the basic conversation protocol boundary. See also 
conversation and basic conversation. 

MOR. Miscellaneous data record. 

message. (1) (TC97) A group of characters and 
control bit sequences transferred as an entity. (2) In 
VTAM, the amount of function management data (FMD) 
transferred to VTAM by the application program with 
one SEND request. 

message unit. In SNA, the unit of data processed by 
any layer; for example, a basic information unit (BIU), a 
path information unit (PIU), or a request/response unit 
(RU). 

MIC. Middle-in-chain. 

middle-in-chain (MIC). A request unit (RU) whose 
request header (RH) begin chain indicator and RH end 
chain indicator are both off. See also RU chain. 

migration. Installing a new version or release of a 
program when an earlier version or release is already 
in place. 

minor node. In VTAM, a uniquely-defined resource 
within a major node. See node and major node. 

miscellaneous data record (MDR). A record of a 
network hardware error recorded by the NCP and sent 
to the VTAM host that owns the failing component. 

Then VTAM writes the error on the operating system 
error data set. 

modem. A device that modulates and demodulates 
signals transmitted over data communication facilities. 
The term is a contraction for modulator-demodulator. 
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mode name. A symbolic name for a set of session 
characteristics. For LU 6.2, a mode name and a 
partner LU name together define a group of parallel 
sessions having the same characteristics. 

MOSS. Maintenance and operator subsystem. 

MSHP. Maintain system history program. 

multiple-domain network. In SNA, a network with more 
than one system services control point (SSCP). Con¬ 
trast with single-domain network. 

Multiple Virtual Storage (MVS). An IBM licensed 
program whose full name is the Operating 
System/Virtual Storage (OS/VS) with Multiple Virtual 
Storage/System Product for System/370. It is a soft¬ 
ware operating system controlling the execution of pro¬ 
grams. 

Multiple Virtual Storage for Extended Architecture 
(MVS/XA). An IBM licensed program whose full name 
is the Operating System/Virtual Storage (OS/VS) with 
Multiple Virtual Storage/System Product for Extended 
Architecture. Extended architecture allows 31-bit 
storage addressing. MVS/XA is a software operating 
system controlling the execution of programs. 

MVS. Multiple Virtual Storage operating system. 

MVS/XA. Multiple Virtual Storage for Extended Archi¬ 
tecture operating system. 

name translation. In SNA network interconnection, 
converting logical unit names, logon mode table 
names, and class-of-service names used in one 
network into equivalent names to be used in another 
network. This function can be provided through 
NetView and invoked by a gateway system services 
control point (SSCP) when necessary. See also alias 
name. 

NAU. Network addressable unit. 

NO. Network control. 

NCCF. Network Communications Control Facility. 

NCP. (1) Network Control Program (IBM licensed 
program). Its full name is Advanced Communications 
Function for the Network Control Program. Synony¬ 
mous with ACF/NCP. (2) Network control program 
(general term). 

NCP major node. In VTAM, a set of minor nodes 
representing resources, such as lines and peripheral 
nodes, controlled by a network control program. See 
major node . 

negative response (NR). In SNA, a response indicating 
that a request did not arrive successfully or was not 


processed successfully by the receiver. Contrast with 
positive response. See exception response. 

NetView. A system 370-based IBM licensed program 
used to monitor a network, manage it, and diagnose its 
problems. 

NetView/PC. A PC-based IBM licensed program 
through which application programs can be used to 
monitor, manage, and diagnose problems in IBM 
Token-Ring networks, non-SNA communication 
devices, and voice networks. 

network. (1) (TC97) An interconnected group of nodes. 
(2) In data processing, a user application network. See 
path control network, public network, SNA network , 
subarea network, type 2.1 network , and user- 
application network. 

network address. In SNA, an address, consisting of 
subarea and element fields, that identifies a link, a link 
station, or a network addressable unit. Subarea nodes 
use network addresses; peripheral nodes use local 
addresses. The boundary function in the subarea node 
to which a peripheral node is attached transforms local 
addresses to network addresses and vice versa. See 
local address. See also network name. 

network address translation. In SNA network intercon¬ 
nection, conversion of the network address assigned to 
a logical unit in one network into an address in an adja¬ 
cent network. This function is provided by the gateway 
NCP that joins the two networks. See also alias 
network address and real network address. 

network addressable unit (NAU). In SNA, a logical unit, 
a physical unit, or a system services control point. It is 
the origin or the destination of information transmitted 
by the path control network. Each NAU has a network 
address that represents it to the path control network. 
See also network name, network address, and path 
control network. 

Network Communications Control Facility (NCCF). An 
IBM licensed program that is a base for command 
processors that can monitor, control, automate, and 
improve the operations of a network. Its function is 
included and enhanced in NetView's command facility. 

network control (NC). In SNA, an RU category used for 
requests and responses exchanged for such purposes 
as activating and deactivating explicit and virtual 
routes and sending load modules to adjacent periph¬ 
eral nodes. See also data flow control layer and 
session control. 

network control mode. The functions of a network 
control program that enable it to direct a communi¬ 
cation controller to perform activities such as polling, 
device addressing, dialing, and answering. Contrast 
with emulation mode. 
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Network Control Program (NCP). An IBM licensed 
program that provides communication controller 
support for single-domain, multiple-domain, and inter¬ 
connected network capability. Its full name is 
Advanced Communications Function for the Network 
Control Program. 

network control program. A program, generated by the 
user from a library of IBM-supplied modules, that con¬ 
trols the operation of a communication controller. 

network controller. A concentrator and protocol con¬ 
verter used with SDLC links. By converting protocols, 
which manage the way data is sent and received, the 
IBM 3710 Network Controller allows the use of non-SNA 
devices with an SNA host processor. 

network identifier (network ID). The network name 
defined to NCPs and hosts to indicate the name of the 
network in which they reside. It is unique across all 
communicating SNA networks, communication among 
domains. 

Network Logical Data Manager (NLDM). An IBM 
licensed program that collects and correlates session- 
related data and provides online access to this informa¬ 
tion. It runs as an NCCF communication network 
management (CNM) application program. Its function 
is included and enhanced in NetView's session 
monitor. 

network management vector transport (NMVT). A man¬ 
agement services request/response unit (RU) that flows 
over an active session between physical unit manage¬ 
ment services and control point management services 
(SSCP-PU session). 

network name. (1) In SNA, the symbolic identifier by 
which end users refer to a network addressable unit 
(NAU), a link, or a link station. See also network 
address. (2) In a multiple-domain network, the name 
of the APPL statement defining a VTAM application 
program is its network name and it must be unique 
across domains. Contrast with ACB name. See unin¬ 
terpreted name. 

network operator. (1) A person or program respon¬ 
sible for controlling the operation of all or part of a 
network. (2) The person or program that controls all 
the domains in a multiple-domain network. Contrast 
with domain operator. 

Network Problem Determination Application (NPDA). 

An IBM licensed program that helps you identify 
network problems, such as hardware, software, and 
microcode, from a central control point using interac¬ 
tive display techniques. It runs as an NCCF communi¬ 
cation network management (CNM) application 
program. Its function is included and enhanced in 
NetView's hardware monitor. 


Network Routing Facility (NRF). An IBM licensed 
program that resides in the NCP, which provides a path 
for messages between terminals, and routes messages 
over this path without going through the host 
processor. 

network services (NS). In SNA, the services within 
network addressable units (NAUs) that control network 
operation through SSCP-SSCP, SSCP-PU, and SSCP-LU 
sessions. See configuration services, maintenance 
services, management services, and session services. 

network services (NS) header. In SNA, a 3-byte field in 
a function management data (FMD) request/response 
unit (RU) flowing in an SSCP-LU, SSCP-PU, or 
SSCP-SSCP session. The network services header is 
used primarily to identify the network services category 
of the request unit (RU) (for example, configuration ser¬ 
vices, session services) and the particular request 
code within a category. 

Network Terminal Option (NTO). An IBM licensed 
program used in conjunction with NCP that allows 
certain non-SNA devices to participate in sessions with 
SNA application programs in the host processor. NTO 
converts non-SNA protocol to SNA protocol when data 
is sent to the host from a non-SNA device and recon¬ 
verts SNA protocol to non-SNA protocol when data is 
sent back to the device. 

NIB. Node initialization block. 

NLDM. Network Logical Data Manager. 

NMVT. Network management vector transport. 

node. (1) In SNA, an endpoint of a link or junction 
common to two or more links in a network. Nodes can 
be distributed to host processors, communication con¬ 
trollers, cluster controllers, or terminals. Nodes can 
vary in routing and other functional capabilities. See 
boundary node, host node, peripheral node, and 
subarea node (including illustration). (2) In VTAM, a 
point in a network defined by a symbolic name. See 
major node and minor node. 

node initialization block (NIB). In VTAM, a control block 
associated with a particular node or session that con¬ 
tains information used by the application program to 
identify the node or session and to indicate how com¬ 
munication requests on a session are to be handled by 
VTAM. 

node name. In VTAM, the symbolic name assigned to a 
specific major or minor node during network definition. 

node type. In SNA, a designation of a node according 
to the protocols it supports and the network address¬ 
able units (NAUs) that it can contain. Five types are 
defined: 1, 2.0, 2.1, 4, and 5. Type 1, type 2.0, and type 
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2.1 nodes are peripheral nodes; type 4 and type 5 
nodes are subarea nodes. See also type 2.1 node. 

Non-SNA Interconnection (NSI). An IBM licensed 
program that provides format identification (FID1/4) 
support for selected non-SNA facilities. Thus, it allows 
SNA and non-SNA facilities to share SDLC links. It also 
allows the remote concentration of selected non-SNA 
devices along with SNA devices. 

nonswitched line. A telecommunication line on which 
connections do not have to be established by dialing. 
Contrast with switched line. 

no response. In SNA, a value in the form-of-response- 
requested field of the request header (RH) indicating 
that no response is to be returned to the request, 
whether or not the request is received and processed 
successfully. Contrast with definite response and 
exception response. 

normal flow. In SNA, a data flow designated in the 
transmission header (TH) that is used primarily to carry 
end-user data. The rate at which requests flow on the 
normal flow can be regulated by session-level pacing. 
Normal and expedited flows move in both the primary- 
to-secondary and secondary-to-primary directions. 
Contrast with expedited flow. 

notify. A network services request that is sent by an 
SSCP to a logical unit (LU) to inform the LU of the status 
of a procedure requested by the LU. 

NPDA. Network Problem Determination Application. 

NR. Negative response. 

NRF. Network Routing Facility. 

NS. Network services. 

NSI. Non-SNA Interconnection. 

NTO. Network Terminal Option. 

OAF. Origin address field. 

OBR. Outboard record. 

OIC. Only-in-chain. 

OLU. Origin logical unit. 

online. Stored in a computer and accessible from a ter¬ 
minal. 

only-in-chain (OIC). A request unit for which the 
request header (RH) begin chain indicator and RH end 
chain indicator are both on. See also RU chain. 


operand. (1) (ISO) An entity on which an operation is 
performed. (2) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose 
value an operator is applied. See also definition state - 
ment, keyword , keyword parameter, and parameter. 

operator. (1) In a language statement, the lexical 
entity that indicates the action to be performed on oper¬ 
ands. (2) A person who operates a machine. See 
network operator. See also definition statement. 

operator profile. In the NetView program, the 
resources and activities a network operator has control 
over. The statements defining these resources and 
activities are stored in a file that is activated when the 
operator logs on. 

orderly closedown. The orderly deactivation of VTAM 
and its domain. An orderly closedown does not com¬ 
plete until all application programs have closed their 
application control blocks (ACBs). Until then, 
RPL-based operations continue; however, no new ses¬ 
sions can be established and no new ACBs can be 
opened. Contrast with cancel closedown and quick 
closedown. 

origin address field (OAF). In SNA, a field in a FIDO or 
FID1 transmission header that contains the address of 
the originating network addressable unit (NAU). Con¬ 
trast with destination address field. See also format 
identification (FID) field and local session identification 
(LSID). 

origin logical unit (OLU). The logical unit from which 
data is sent. Contrast with destination logical unit 
(DLU). 

outboard record. A record originated by I/O and com¬ 
munication components and supported by the access 
methods. It describes permanent errors or reports sta¬ 
tistical data. 

PAB. Process anchor block. 

pacing. In SNA, a technique by which a receiving com¬ 
ponent controls the rate of transmission of a sending 
component to prevent overrun or congestion. See 
session-level pacing, send pacing, and virtual route 
(VR) pacing. See also flow control. 

pacing group. In SNA, (1) The path information units 
(PIUs) that can be transmitted on a virtual route before 
a virtual-route pacing response is received, indicating 
that the virtual route receiver is ready to receive more 
PIUs on the route. Synonymous with window. (2) The 
requests that can be transmitted on the normal flow in 
one direction on a session before a session-level 
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pacing response is received, indicating that the 
receiver is ready to accept the next group of requests. 

pacing response. In SNA, an indicator that signifies a 
receiving component's readiness to accept another 
pacing group; the indicator is carried in a response 
header (RH) for session-level pacing, and in a trans¬ 
mission header (TH) for virtual route pacing. 

packet switching. (TC97) The process of routing and 
transferring data by means of addressed packets so 
that a channel is occupied only during the transmission 
of a packet; upon completion of the transmission, the 
channel is made available for the transfer of other 
packets. 

page. (1) The portion of a panel that is shown on a 
display surface at one time. (2) To move back and 
forth among the pages of a multiple-page panel. See 
also scroll. (3) (ISO) In a virtual storage system, a 
fixed-length block that has a virtual address and that 
can be transferred between real storage and auxiliary 
storage. (4) To transfer instructions, data, or both 
between real storage and external page or auxiliary 
storage. 

panel. (1) A formatted display of information that 
appears on a terminal screen. See also help panel and 
task panel. Contrast with screen . (2) In computer 
graphics, a display image that defines the locations and 
characteristics of display fields on a display surface. 

parameter. (1) (ISO) A variable that is given a constant 
value for a specified application and that may denote 
the application. (2) An item in a menu for which the 
user specifies a value or for which the system provides 
a value when the menu is interpreted. (3) Data passed 
to a program or procedure by a user or another 
program, namely as an operand in a language state¬ 
ment, as an item in a menu, or as a shared data struc¬ 
ture. See also keyword , keyword parameter, and 
operand. 

parallel links. In SNA, two or more links between adja¬ 
cent subarea nodes. 

parallel sessions. In SNA, two or more concurrently 
active sessions between the same two logical units 
(LUs) using different pairs of network addresses. Each 
session can have independent session parameters. 

partitioned emulation program (PEP) extension. A 

function of a network control program that enables a 
communication controller to operate some telecommu¬ 
nication lines in network control mode while simultane¬ 
ously operating others in emulation mode. 

path. (1) In SNA, the series of path control network 
components (path control and data link control) that are 
traversed by the information exchanged between two 
network addressable units (NAUs). See also explicit 


route (ER), route extension , and virtuai route (VR). 

(2) In VTAM when defining a switched major node, a 
potential dial-out port that can be used to reach that 
node. (3) In the NetView/PC program, a complete line 
in a configuration that contains all of the resources in 
the service point command service (SPCS) query link 
configuration request list. 

path control (PC). The function that routes message 
units between network addressable units (NAUs) in the 
network and provides the paths between them. It con¬ 
verts the BIUs from transmission control (possibly seg¬ 
menting them) into path information units (PIUs) and 
exchanges basic transmission units (BTUs) and one or 
more PIUs with data link control. Path control differs 
for peripheral nodes, which use local addresses for 
routing, and subarea nodes, which use network 
addresses for routing. See peripheral path control and 
subarea path control. See also link, peripheral node, 
and subarea node. 

path control (PC) layer. In SNA, the layer that manages 
the sharing of link resources of the SNA network and 
routes basic information units (BIUs) through it. See 
also BIU segment , blocking of PIUs , data link control 
layer , and transmission control layer. 

path control (PC) network. In SNA, the part of the SNA 
network that includes the data link control and path 
control layers. See SNA network and user application 
network. See also boundary function. 

path Information unit (PIU). In SNA, a message unit 
consisting of a transmission header (TH) alone, or of a 
TH followed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 

PC. (1) Path control. (2) Personal Computer. Its full 
name is the IBM Personal Computer. 

PCID. Procedure-correlation identifier. 

PEP. Partitioned emulation program. 

performance class. In the NetView program, a 
description of an objective or commitment of perform¬ 
ance. It consists of a performance class name, 
boundary definitions, response time definition, 
response time ranges, and response time percentage 
objectives. Sessions may be assigned performance 
classes. 

performance error. Synonym for temporary error. 

peripheral host node. A node that provides an applica¬ 
tion program interface (API) for running application 
programs but does not provide SSCP functions and is 
not aware of the network configuration. The peripheral 
host node does not provide subarea node services. It 
has boundary function provided by its adjacent 
subarea. See boundary node, host node , node, periph- 
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eraI node, subarea host node , and subarea node. See 
also boundary function and node type. 

peripheral LU. In SNA, a logical unit representing a 
peripheral node. 

peripheral node. In SNA, a node that uses local 
addresses for routing and therefore is not affected by 
changes in network addresses. A peripheral node 
requires boundary-function assistance from an adja¬ 
cent subarea node. A peripheral node is a physical 
unit (PU) type 1, 2.0, or 2.1 node connected to a 
subarea node with boundary function within a subarea. 
See boundary node, host node, node, peripheral host 
node, subarea host node , and subarea node. See also 
boundary function and node type. 

peripheral path control. The function in a peripheral 
node that routes message units between units with 
local addresses and provides the paths between them. 
See path control and subarea path control. See also 
boundary function, peripheral node, and subarea node. 

peripheral PU. In SNA, a physical unit representing a 
peripheral node. 

permanent error. A resource error that cannot be 
resolved by error recovery programs. Contrast with 
temporary error. 

Personal Computer (PC). The IBM Personal Computer 
line of products including the 5150 and subsequent 
models. 

physical connection. In VTAM, a point-to-point con¬ 
nection or multipoint connection. Synonymous with 
connection. 

physical unit (PU). In SNA, a type of network address¬ 
able unit (NAU). A physical unit (PU) manages and 
monitors the resources (such as attached links) of a 
node, as requested by a system services control point 
(SSCP) through an SSCP-PU session. An SSCP acti¬ 
vates a session with the physical unit in order to indi¬ 
rectly manage, through the PU, resources of the node 
such as attached links. See also peripheral PU and 
subarea PU. 

physical unit (PU) services. In SNA, the components 
within a physical unit (PU) that provide configuration 
services and maintenance services for SSCP-PU ses¬ 
sions. See also logical unit (LU) services. 

PIU. Path information unit. 

plaintext. Synonym for clear data. 

PLU. Primary logical unit. 

polling. (1) * Interrogation of devices for purposes 
such as to avoid contention, to determine operational 


status, or to determine readiness to send or receive 
data. (2) (TC97) The process whereby stations are 
invited, one at a time, to transmit. 

positional operand. An operand in a language state¬ 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 

positive response. A response indicating that a request 
was received and processed. Contrast with negative 
response. 

primary application program. In VTAM, an application 
program acting as the primary end of an LU-LU 
session. 

primary half-session. In SNA, the half-session that 
sends the session activation request. See also primary 
logical unit. Contrast with secondary half-session. 

primary logical unit (PLU). In SNA, the logical unit (LU) 
that contains the primary half-session for a particular 
LU-LU session. Each session must have a PLU and 
secondary logical unit (SLU). The PLU is the unit 
responsible for the bind and is the controlling LU for 
the session. A particular LU may contain both primary 
and secondary half-sessions for different active LU-LU 
sessions. Contrast with secondary logical unit (SLU). 

primary session. An extended recovery facility (XRF) 
session between the active application subsystem and 
a terminal user. 

problem determination. The process of identifying the 
source of a problem; for example, a program compo¬ 
nent, a machine failure, telecommunication facilities, 
user or contractor-installed programs or equipment, an 
environment failure such as a power loss, or a user 
error. 

process anchor block (PAB). In VTAM, a process 
scheduling services dispatch point. 

procedure-correlation identifier (PCID). In SNA, a value 
used by a control point to correlate requests and 
replies. 

profile. In the Conversational Monitor System (CMS) or 
the group control system (GCS), the characteristics 
defined by a PROFILE EXEC file that executes automat¬ 
ically after the system is loaded into a virtual machine. 
See also operator profile. 

program temporary fix (PTF). A temporary solution or 
bypass of a problem diagnosed by IBM in a current 
unaltered release of the program. 

protocol. (1) (CCITT/ITU) A specification for the format 
and relative timing of information exchanged between 
communicating parties. (2) (TC97) The set of rules 
governing the operation of functional units of a commu- 
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nication system that must be followed if communication 
is to be achieved. (3) In SNA, the meanings of, and the 
sequencing rules for, requests and responses used for 
managing the network, transferring data, and synchro¬ 
nizing the states of network components. See also 
bracket protocol. Synonymous with line control disci¬ 
pline and line discipline. See also link protocoi. 

protocol boundary. (1) A synonym for the architec¬ 
turally defined logical unit (LU) 6.2 application program 
interface (API). (2) Any internal interface between 
components in a node. 

PTF. Program temporary fix. 

PU. Physical unit. 

PU type. Physical unit type. 

public network. A network established and operated by 
communication common carriers or telecommunication 
Administrations for the specific purpose of providing 
circuit-switched, packet-switched, and leased-circuit 
services to the public. Contrast with user-application 
network. 

PU-PU flow. In SNA, the exchange between physical 
units (PUs) of network control requests and responses. 

quick closedown. In VTAM, a closedown in which any 
RPL-based communication macroinstruction is termi¬ 
nated (posted complete with an error code) and no new 
sessions can be established and no new ACBs can be 
opened. See also cancel closedown and orderly close¬ 
down. 

quiesce. (1) * To bring a system or a device to a halt 
by rejecting new requests for work. (2) In a VTAM 
application program, for one node to stop another node 
from sending synchronous-flow messages. 

RDT. Resource definition table. 

real name. The name by which a logical unit (LU), 
logon mode table, or class-of-service (COS) table is 
known within the SNA network in which it resides. 

real network address. The address by which a logical 
unit (LU) is known within the SNA network in which it 
resides. 

receive pacing. In SNA, the pacing of message units 
that the component is receiving. See also send pacing. 

RECFMS. Record formatted maintenance statistics. 

RECMS. Record maintenance statistics. 

Recommendation X.21 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for a general purpose inter¬ 


face between data terminal equipment and data circuit 
equipment for synchronous operations on a public data 
network. 

Recommendation X.25 (Geneva 1980). A Consultative 
Committee on International Tejegraph and Telephone 
(CCITT) recommendation for the interface between data 
terminal equipment and packet-switched data net¬ 
works. See also packet switching. 

recommended action. Procedures suggested by 
NetView that can be used to determine the causes of 
network problems. 

record formatted maintenance statistics (RECFMS). A 
statistical record built by an SNA controller and usually 
solicited by the host. 

record maintenance statistics (RECMS). An SNA error 
event record built from an NCP or line error and sent 
unsolicited to the host. 

release. For VTAM, to relinquish control of resources 
(communication controllers or physical units). See also 
resource takeover. Contrast with acquire (2). 

remote. Concerning the peripheral parts of a network 
not centrally linked to the host processor and generally 
using telecommunication lines with public right-of-way. 

request header (RH). In SNA, control information pre¬ 
ceding a request unit (RU). See also request/response 
header (RH). 

request parameter list (RPL). In VTAM, a control block 
that contains the parameters necessary for processing 
a request for data transfer, for establishing or termi¬ 
nating a session, or for some other operation. 

request unit (RU). In SNA, a message unit that contains 
control information, end-user data, or both. 

request/response header (RH). In SNA, control infor¬ 
mation, preceding a request/response unit (RU), that 
specifies the type of RU (request unit or response unit) 
and contains control information associated with that 
RU. 

request/response unit (RU). In SNA, a generic term for 
a request unit or a response unit. See also request unit 
(RU) and response unit. 

required cryptographic session. A cryptographic 
session in which all outbound data is enciphered and 
all inbound data is deciphered. Synonymous with man¬ 
datory cryptographic session. Contrast with selective 
cryptographic session and clear session. 

resource. (1) Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the proc- 


LY30-5601-1 €> Copyright IBM Corp. 1984, 1989 


Glossary 705 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


essing unit, data sets, and control or processing pro¬ 
grams. (2) In the NetView program, any hardware or 
software that provides function to the network. 

resource definition table (RDT). In VTAM, a table that 
describes the characteristics of each node available to 
VTAM and associates each node with a network 
address. This is the main VTAM network configuration 
table. 

resource hierarchy. In VTAM, the relationship among 
network resources in which some resources are subor¬ 
dinate to others as a result of their position in the 
network structure and architecture; for example, the 
logical units (LUs) of a peripheral physical unit (PU) are 
subordinate to that PU, which, in turn, is subordinate to 
the link attaching it to its subarea node. 

resource takeover. In VTAM, action initiated by a 
network operator to transfer control of resources from 
one domain to another. See also acquire (2) and 
release. See takeover. 

resource types, in the NetView program, a concept to 
describe the organization of panels. Resource types 
are defined as central processing unit, channel, control 
unit, and I/O device for one category; and communi¬ 
cation controller, adapter, link, cluster controller, and 
terminal for another category. Resource types are 
combined with data types and display types to describe 
display organization. See also data types and display 
types. 

response header (RH). In SNA, a header, optionally fol¬ 
lowed by a response unit (RU), that indicates whether 
the response is positive or negative and that may 
contain a pacing response. See also negative 
response , pacing response , and positive response. 

response time. (1) The amount of time it takes after a 
user presses the enter key at the terminal until the 
reply appears at the terminal. (2) For response time 
monitoring, the time from the activation of a transaction 
until a response is received, according to the response 
time definition coded in the performance class. 

response time monitor (RTM). A feature available with 
certain hardware devices to allow measurement of 
response times, which may be collected and displayed 
by NetView. 

response unit (RU). In SNA, a message unit that 
acknowledges a request unit; it may contain prefix 
information received in a request unit. If positive, the 
response unit may contain additional information (such 
as session parameters in response to Bind Session), or 
If negative, contains sense data defining the exception 
condition. 

return code. * A code [returned from a program] used 
to influence the execution of succeeding Instructions. 


REX. Route extension. 

RH. Request/response header. 

ring. A network configuration where a series of 
attaching devices are connected by unidirectional 
transmission links to form a closed path. 

route. See explicit route and virtual route. 

route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also path , explicit route (ER), and 
virtual route (VR). 

RPL. Request parameter list. 

RPL exit routine. In VTAM, an application program exit 
routine whose address has been placed in the EXIT 
field of a request parameter list (RPL). VTAM invokes 
the routine to indicate that an asynchronous request 
has been completed. See EXLST exit routine. 

RPL-based macroinstruction. In VTAM, a macroin¬ 
struction whose parameters are specified by the user 
in a request parameter list. 

RTM. Response time monitor. 

RU. Request/response unit. 

RU chain. In SNA, a set of related request/response 
units (RUs) that are consecutively transmitted on a par¬ 
ticular normal or expedited data flow. The request RU 
chain is the unit of recovery: if one of the RUs in the 
chain cannot be processed, the entire chain is dis¬ 
carded. Each RU belongs to only one chain, which has 
a beginning and an end indicated by means of control 
bits in request/response headers within the RU chain. 
Each RU can be designated as first-in-chain (FIC), last- 
in-chain (LIC), middle-in-chain (MIC), or only-in-chain 
(OIC). Response units and expedited-flow request units 
are always sent as only-in-chain. 

SAW data. Synonym for session awareness (SAW) 
data. 

SC. Session control. 

scanner. (1) A device capable of electronically 
reviewing amounts of data and translating the data into 
a machine readable form. (2) For the 3725 communi¬ 
cation controller, a processor dedicated to controlling a 
small number of telecommunication lines. It provides 
the connection between the line interface coupler hard¬ 
ware and the central control unit. 
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scanner interface trace (SIT). A record of the activity 
within the communication scanner processor (CSP) for 
a specified data link between a 3725 Communication 
Controller and a resource. 

screen. An illuminated display surface; for example, 
the display surface of a CRT or plasma panel. Contrast 
with panel. 

scroll. To move all or part of the display image verti¬ 
cally to display data that cannot be observed within a 
single display image. See also page (2). 

SDLC. Synchronous Data Link Control. 

secondary half-session. In SNA, the half-session that 
receives the session-activation request. See also sec¬ 
ondary logical unit (SLU). Contrast with primary half¬ 
session. 

secondary logical unit (SLU). In SNA, the logical unit 
(LU) that contains the secondary half-session for a par¬ 
ticular LU-LU session. An LU may contain secondary 
and primary half-sessions for different active LU-LU 
sessions. Contrast with primary logical unit (PLU). 

secondary logical unit (SLU) key. A key-encrypting key 
used to protect a session cryptography key during its 
transmission to the secondary half-session. 

segment. See iink connection segment. 

selective cryptographic session. A cryptographic 
session in which an application program is allowed to 
specify the request units to be enciphered. Contrast 
with required cryptographic session and dear session. 

send pacing. In SNA, pacing of message units that a 
component is sending. See also receive pacing. 

service point (SR). An entry point that supports appli¬ 
cations that provide network management for 
resources not under the direct control of itself as an 
entry point. Each resource is either under the direct 
control of another entry point or not under the direct 
control of any entry point. A service point accessing 
these resources is not required to use SNA sessions 
(unlike a focal point). A service point is needed when 
entry point support is not yet available for some 
network management function. 

service point command service (SPCS). An extension 
of the command facility in the NetView program that 
allows the host processor to communicate with a 
service point by using the communication network 
management (CNM) interface. 

session. In SNA, a logical connection between two 
network addressable units (NAUs) that can be acti¬ 
vated, tailored to provide various protocols, and deacti¬ 
vated, as requested. Each session is uniquely 


identified in a transmission header (TH) by a pair of 
network addresses, identifying the origin and destina¬ 
tion NAUs of any transmissions exchanged during the 
session. See half-session, LU-LU session, SSCP-LU 
session, SSCP-PU session, and SSCP-SSCP session. 
See also LU-LU session type and PU-PU flow. 

session activation request In SNA, a request that acti¬ 
vates a session between two network addressable units 
(NAUs) and specifies session parameters that control 
various protocols during session activity; for example, 
BIND and ACTPU. Contrast with session deactivation 
request. 

session awareness (SAW) data. Data collected by 
NetView about a session that includes the session type, 
the names of session partners, and information about 
the session activation status. It is collected for LU-LU, 
SSCP-LU, SSCP-PU, and SSCP-SSCP sessions and for 
non-SNA terminals not supported by NTO. It can be 
displayed in various forms, such as most recent ses¬ 
sions lists. 

session control (SC). In SNA, (1) One of the compo¬ 
nents of transmission control. Session control is used 
to purge data flowing in a session after an unrecover¬ 
able error occurs, to resynchronize the data flow after 
such an error, and to perform cryptographic verifica¬ 
tion. (2) A request unit (RU) category used for requests 
and responses exchanged between the session control 
components of a session and for session activation and 
deactivation requests and responses. 

session control in-bound processing exit (SCIP). A 
user exit that receives control when certain request 
units (RUs) are received by VTAM. 

session cryptography key. In SNA, a data encrypting 
key used to encipher and decipher function manage¬ 
ment data (FMD) requests transmitted in an LU-LU 
session that uses cryptography. 

session data. Data about a session, collected by 
NetView, that consists of session awareness data and 
session trace data. 

session deactivation request. In SNA, a request that 
deactivates a session between two network address¬ 
able units (NAUs); for example, UNBIND and DACTPU. 
Synonymous with generic unbind. Contrast with 
session activation request. 

session information block (SIB). A control block that 
contains information about a particular SNA session. 

session-initiation request. In SNA, an Initiate or logon 
request from a logical unit (LU) to a control point (CP) 
that an LU-LU session be activated. 

session-level pacing. In SNA, a flow control technique 
that permits a receiver to control the data transfer rate 
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(the rate at which it receives request units) on the 
normal flow. It is used to prevent overloading a 
receiver with unprocessed requests when the sender 
can generate requests faster than the receiver can 
process them. See also pacing and virtual route 
pacing. 

session limit. (1) In SNA, (a) the maximum number of 
concurrently active LU-LU sessions a particular logical 
unit can support; (b) the limit that determines how 
many sessions may be active between two logical units 
(LUs) that are using LU 6.2 protocols and a given mode 
name. Each partner LU is allocated a minimum share 
of contention-winner sessions within this limit. (2) In 
the network control program, the maximum number of 
concurrent line-scheduling sessions on a non-SDLC, 
multipoint line. 

session monitor. The component of NetView that col¬ 
lects and correlates session-related data and provides 
online access to this information. 

session parameters. In SNA, the parameters that 
specify or constrain the protocols (such as bracket pro¬ 
tocol and pacing) for a session between two network 
addressable units. See also logon mode. 

session partner. In SNA, one of the two network 
addressable units (NAUs) having an active session. 

session services. In SNA, one of the types of network 
services in the control point (CP) and in the logical unit 
(LU). These services provide facilities for an LU or a 
network operator to request that the SSCP initiate or 
terminate sessions between logical units. See config¬ 
uration services , maintenance services , and manage¬ 
ment services. 

session-termination request. In VTAM, a request that 
an LU-LU session be terminated. 

session trace. In the NetView program, the function 
that collects session trace data for sessions involving 
specified resource types or involving a specific 
resource. 

session trace data. Data relating to sessions that is 
collected by NetView whenever a session trace is 
started and that consists of session activation parame¬ 
ters, VTAM path information unit (PIU) data, and NCP 
data. 

shadow resource. In VTAM, an alternate represen¬ 
tation of a network resource that is retained as a defi¬ 
nition for possible future use. 

shared. Pertaining to the availability of a resource to 
more than one use at the same time. 

shutdown. To stop or quiesce a NetView/PC or a 
NetView/PC application program. 


SIB. Session information block. 

simulated logon. A session-initiation request gener¬ 
ated when a VTAM application program issues a 
SIMLOGON macroinstruction. The request specifies a 
logical unit (LU) with which the application program 
wants a session in which the requesting application 
program will act as the primary logical unit (PLU). 

single-domain network. In SNA, a network with one 
system services control point (SSCP). Contrast with 
multiple-domain network. 

SIT. Scanner interface trace. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SMP. System Modification Program. 

SMP/E. System Modification Program Extended. 

SNA. Systems Network Architecture. 

SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con¬ 
trolling the resources of various network configura¬ 
tions. The SNA network consists of network 
addressable units (NAUs), boundary function compo¬ 
nents, and the path control network. 

SNA network interconnection. The connection, by gate¬ 
ways, of two or more independent SNA networks to 
allow communication between logical units in those 
networks. The individual SNA networks retain their 
independence. 

SP. Service point. 

SPCS. Service point command service. 

span. In the NetView program, a user-defined group of 
network resources within a single domain. Each major 
or minor node is defined as belonging to one or more 
spans. See also span of control. 

span of control. The total network resources over 
which a particular network operator has control. All 
the network resources listed in spans associated 
through profile definition with a particular network 
operator are within that operator's span of control. 

SS. Start-stop. 

SSCP. System services control point. 
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SSCP ID. In SNA, a number that uniquely identifies a 
system services control point (SSCP). The SSCP ID is 
used in session activation requests sent to physical 
units (PUs) and other SSCPs. 

SSCP rerouting. In SNA network interconnection, the 
technique used by the gateway system services control 
point (SSCP) to send session-initiation request units 
(RUs), by way of a series of SSCP-SSCP sessions, from 
one SSCP to another, until the owning SSCP is reached. 

SSCP-LU session. In SNA, a session between a system 
services control point (SSCP) and a logical unit (LU); 
the session enables the LU to request the SSCP to help 
initiate LU-LU sessions. 

SSCP-PU session. In SNA, a session between a system 
services control point (SSCP) and a physical unit (PU); 
SSCP-PU sessions allow SSCPs to send requests to 
and receive status information from individual nodes in 
order to control the network configuration. 

SSCP-SSCP session. In SNA, a session between the 
system services control point (SSCP) in one domain 
and the SSCP in another domain. An SSCP-SSCP 
session is used to initiate and terminate cross-domain 
LU-LU sessions. 

SSP. System Support Programs (IBM licensed 
program). Its full name is Advanced Communications 
Function for System Support Programs. Synonymous 
with ACF/SSP. 

ST. Session configuration screen abbreviation. 

start option. In VTAM, a user-specified or IBM-supplied 
option that determines certain conditions that are to 
exist during the time a VTAM system is operating. 

Start options can be predefined or specified when 
VTAM is started. 

statement. A language syntactic unit consisting of an 
operator, or other statement identifier, followed by one 
or more operands. See definition statement, 

statement identifier. The lexical entity in a language 
statement that indicates the purpose of the statement, 
such as the action to be performed or the resource 
being defined. See also definition statement , definition 
statement identifier , and operator. 

station. (1) One of the input or output points of a 
network that uses communication facilities; for 
example, the telephone set in the telephone system or 
the point where the business machine interfaces with 
the channel on a leased private line. (2) One or more 
computers, terminals, or devices at a particular 
location. 


status code. In VTAM, information on the status of a 
resource as shown in a 10-character state code; for 
example, STATEACTIV for active. 

status modifier. (1) In a System/370 status code, an 
indicator of the input/output (I/O) status. (2) In VTAM, 
a specific character appearing in specific positions of 
the status code; for example, B in the 10th position indi¬ 
cates a backup. 

subarea. A portion of the SNA network consisting of a 
subarea node, any attached peripheral nodes, and their 
associated resources. Within a subarea node, all 
network addressable units, links, and adjacent link 
stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 

subarea address. In SNA, a value in the subarea field 
of the network address that identifies a particular 
subarea. See also eiement address. 

subarea host node. A host node that provides both 
subarea function and an application program interface 
(API) for running application programs. It provides 
system services control point (SSCP) functions, 
subarea node services, and is aware of the network 
configuration. See boundary node , communication 
management configuration host node , data host node, 
host node, node , peripherai node , and subarea node. 
See also boundary function and node type . 

subarea link, in SNA, a link that connects two subarea 
nodes. See channei fink and fink. 

subarea node. In SNA, a node that uses network 
addresses for routing and whose routing tables are 
therefore affected by changes in the configuration of 
the network. Subarea nodes can provide gateway func¬ 
tion, and boundary function support for peripheral 
nodes. Type 4 and type 5 nodes are subarea nodes. 
See boundary node , host node , node, peripherai node, 
and subarea host node. See also boundary function 
and node type. 

subarea path control. The function in a subarea node 
that routes message units between network address¬ 
able units (NAUs) and provides the paths between 
them. See path controi and peripherai path controi. 

See also boundary function , peripherai node , and 
subarea node. 

subarea PU. In SNA, a physical unit (PU) in a subarea 
node. 

subsystem. A secondary or subordinate system, 
usually capable of operating independent of, or asyn¬ 
chronously with, a controlling system. 
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supervisor. The part of a control program that coordi¬ 
nates the use of resources and maintains the flow of 
processing unit operations. 

supervisor call (SVC). A request that serves as the 
interface into operating system functions, such as allo¬ 
cating storage. The SVC protects the operating system 
from inappropriate user entry. All operating system 
requests must be handled by SVCs. 

supervisor call (SVC) instruction. An instruction that 
interrupts the program being executed and passes 
control to the supervisor so that it can perform a spe¬ 
cific service indicated by the instruction. 

SVC. (1) Supervisor call. (2) Switched virtual circuit. 

switched line. A communication line in which the con¬ 
nection between the communication controller and a 
remote link station is established by dialing. 

switched major node. In VTAM, a major node whose 
minor nodes are physical units and logical units 
attached by switched SDLC links. 

switched virtual circuit (SVC). An X.25 circuit that is 
dynamically established when needed. The X.25 equiv¬ 
alent of a switched line. 

symptom string. A structured character string written 
to a file when VTAM detects certain error conditions. 

Synchronous Data Link Control (SDLC). A discipline for 
managing synchronous, code-transparent, serial-by-bit 
information transfer over a link connection. Trans¬ 
mission exchanges may be duplex or half-duplex over 
switched or nonswitched links. The configuration of the 
link connection may be point-to-point, multipoint, or 
loop. SDLC conforms to subsets of the Advanced Data 
Communication Control Procedures (ADCCP) of the 
American National Standards Institute and High-Level 
Data Link Control (HDLC) of the International Standards 
Organization. 

synchronous operation. In VTAM, a communication, or 
other operation in which VTAM, after receiving the 
request for the operation, does not return control to the 
program until the operation is completed. Contrast 
with asynchronous operation. 

synchronous request. In VTAM, a request for a syn¬ 
chronous operation. Contrast with asynchronous 
request. 

system management facility (SMF). A standard feature 
of MVS that collects and records a variety of system 
and job-related information. 

System Modification Program (SMP). An operating 
system component that facilitates the process of 


installing and servicing an MVS system. See also 
System Modification Program Extended. 

System Modification Program Extended (SMP/E). An 
IBM licensed program that facilitates the process of 
installing and servicing an MVS system. See also 
System Modification Program. 

system services control point (SSCP). In SNA, a central 
location point within an SNA network for managing the 
configuration, coordinating network operator and 
problem determination requests, and providing direc¬ 
tory support and other session services for end users 
of the network. Multiple SSCPs, cooperating as peers, 
can divide the network into domains of control, with 
each SSCP having a hierarchical control relationship to 
the physical units and logical units within its domain. 

system services control point (SSCP) domain. The 
system services control point and the physical units 
(PUs), logical units (LUs), links, link stations and all the 
resources that the SSCP has the ability to control by 
means of activation requests and deactivation 
requests. 

Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and opera¬ 
tional sequences for transmitting information units 
through and controlling the configuration and operation 
of networks. 

System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 

takeover. The process by which the failing active sub¬ 
system is released from its extended recovery facility 
(XRF) sessions with terminal users and replaced by an 
alternate subsystem. See resource takeover. 

TAP. Trace analysis program. Synonymous with 
ACF/TAP. 

task. A basic unit of work to be accomplished by a 
computer. The task is usually specified to a control 
program in a multiprogramming or multiprocessing 
environment. 

task panel. Online display from which you communi¬ 
cate with the program in order to accomplish the pro¬ 
gram's function, either by selecting an option provided 
on the panel or by entering an explicit command. See 
help panel. 

TC. Transmission control. 

TCAM. (1) Telecommunications Access Method. Syn¬ 
onymous with ACF/TCAM. (2) The IBM licensed 
program whose full name is Advanced Communi¬ 
cations Function for TCAM and that provides queued 
message handling. TCAM Versions t and 2 are access 
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methods, but TCAM Version 3 is a message handling 
subsystem. 

TCAS. Terminal control address space. 

telecommunication line. Any physical medium such as 
a wire or microwave beam, that is used to transmit 
data. Synonymous with transmission line . 

teletypewriter exchange service (TWX). Teletypewriter 
service in which suitably arranged teletypewriter 
stations are provided with lines to a central office for 
access to other such stations throughout the U.S. and 
Canada. Both baudot and ASCII-coded machines are 
used. Business machines may also be used with 
certain restrictions. 

temporary error. A resource failure that can be 
resolved by error recovery programs. Synonymous 
with performance error . Contrast with permanent 
error . 

terminal. A device that is capable of sending and 
receiving information over a link; it is usually equipped 
with a keyboard and some kind of display, such as a 
screen or a printer. 

terminal control address space (TCAS). The part of 
TSO/VTAM that provides logon services for TSO/VTAM 
users. 

TERMINATE. In SNA, a request unit that is sent by a 
logical unit (LU) to its system services control point 
(SSCP) to cause the SSCP to start a procedure to end 
one or more designated LU-LU sessions. 

TG. Transmission group. 

TH. Transmission header. 

threshold. In the NetView program, refers to a per¬ 
centage value set for a resource and compared to a 
calculated error-to-traffic ratio. 

TIC. Token-ring interface coupler. 

time sharing option (TSO). An optional configuration of 
the operating system that provides conversational time 
sharing from remote stations. 

time sharing option for VTAM (TSO/VTAM). An optional 
configuration of the operating system that provides 
conversational time sharing from remote stations in a 
network using VTAM. 

token. A sequence of bits passed from one device to 
another along the token ring. When the token has data 
appended to it, it becomes a frame. 


token ring. A network with a ring topology that passes 
tokens from one attaching device to another. For 
example, the IBM Token-Ring Network. 

token-ring interface coupler (TIC). An adapter that can 
connect a 3725 Communication Controller to an IBM 
Token-Ring Network. 

trace analysis program (TAP). An SSP program 
service aid that assists in analyzing trace data 
produced by VTAM, TCAM, and NCP and provides 
network data traffic and network error reports. 

transaction program. (1) A program that is executed 
by or within an application program and performs ser¬ 
vices related to the processing of a transaction. (2) In 
VTAM, a program that performs services related to the 
processing of a transaction. One or more transaction 
programs may operate within a VTAM application 
program that is using the VTAM application program 
interface (API). In that situation, the transaction 
program would request services from the application 
program, using protocols defined by that application 
program. The application program, in turn, could 
request services from VTAM by issuing the APPCCMD 
macroinstruction. 

transmission control (TC) layer. In SNA, the layer 
within a half-session that synchronizes and paces 
session-level data traffic, checks session sequence 
numbers of requests, and enciphers and deciphers 
end-user data. Transmission control has two compo¬ 
nents: the connection point manager and session 
control. See also half-session. 

transmission control unit (TCU). A communication 
control unit whose operations are controlled solely by 
programmed instructions from the computing system to 
which the unit is attached; no program is stored or exe¬ 
cuted in the unit. Examples are the IBM 2702 and 2703 
Transmission Controls. Contrast with communication 
controller. 

transmission group (TG). In SNA, a group of links 
between adjacent subarea nodes, appearing as a 
single logical link for routing of messages. A trans¬ 
mission group may consist of one or more SDLC links 
(parallel links) or of a single System/370 channel. 

transmission header (TH). In SNA, control information, 
optionally followed by a basic information unit (Bill) or 
a BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 

transmission line. Synonym for telecommunication 
line. 

transmission priority. In SNA, a rank assigned to a 
path information unit (PIU) that determines its preced¬ 
ence for being selected by the transmission group 
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control component of path control for forwarding to the 
next subarea node of the route used by the PIU. 

transmission subsystem component (TSC). The compo¬ 
nent of VTAM that comprises the transmission control, 
path control, and data link control layers of SNA. 

TSC. Transmission subsystem component. 

TSO. Timesharing option. 

TSO/VTAM. Time sharing option for VTAM. 

TWX. Teletypewriter exchange service. 

type 2.1 node (T2.1 node). A node that can attach to an 
SNA network as a peripheral node using the same pro¬ 
tocols as type 2.0 nodes. Type 2.1 nodes can be 
directly attached to one another using peer-to-peer pro¬ 
tocols. See end node , node, and subarea node . See 
also node type . 

type 2.1 node (T2.1 node) control point domain. The 

CP, its logical units (LUs), links, link stations, and all 
resources that it activates and deactivates. 

UNBIND. In SNA, a request to deactivate a session 
between two logical units (LUs). See also session 
deactivation request. Contrast with BIND. 

unformatted. In VTAM, pertaining to commands (such 
as LOGON or LOGOFF) entered by an end user and 
sent by a logical unit in character form. The character- 
coded command must be in the syntax defined in the 
user’s unformatted system services definition table. 
Synonymous with character-coded . Contrast with field- 
formatted . 

unformatted system services (USS). In SNA products, a 
system services control point (SSCP) facility that trans¬ 
lates a character-coded request, such as a logon or 
logoff request into a field-formatted request for proc¬ 
essing by formatted system services and translates 
field-formatted replies and responses into character- 
coded requests for processing by a logical unit. Con¬ 
trast with formatted system services. See also 
converted command. 

uninterpreted name. In SNA, a character string that a 
system services control point (SSCP) is able to convert 
into the network name of a logical unit (LU). Typically, 
an uninterpreted name is used in a logon or Initiate 
request from a secondary logical unit (SLU) to identify 
the primary logical unit (PLU) with which the session is 
requested. 

upstream. In the direction of data flow from the end 
user to the host. Contrast with downstream . 

upstream device. For the IBM 3710 Network Controller, 
a device located in a network such that the device is 
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positioned between the 3710 and a host. A communi¬ 
cation controller upstream from the 3710 is an example 
of an upstream device. Contrast with downstream 
device . 

upstream line. For the IBM 3710 Network Controller, a 
telecommunication line attaching a 3710 to an 
upstream device. Contrast with downstream line. 

user. Anyone who requires the services of a com¬ 
puting system. 

user-application network. A configuration of data proc¬ 
essing products, such as processors, controllers, and 
terminals, established and operated by users for the 
purpose of data processing or information exchange, 
which may use services offered by communication 
common carriers or telecommunication Adminis¬ 
trations. Contrast with public network. 

user exit. A point in an IBM-supplied program at which 
a user routine may be given control. 

USS. Unformatted system services. 

value. (1) (TC97) A specific occurrence of an attribute, 
for example, “blue" for the attribute “color." (2) A 
quantity assigned to a constant, a variable, a param¬ 
eter, or a symbol. 

variable. In the NetView program, a character string 
beginning with & that is coded in a command list and is 
assigned a value during execution of the command list. 

verb. (1) In SNA, the general name for a transaction 
program's request for communication services. (2) In 
VTAM, a programming language element in the logical 
unit (LU) 6.2 application program interface (API) that 
causes an LU 6.2 function to be performed. 

virtual machine. A functional simulation of a computer 
and its associated devices. 

Virtual Machine (VM). A licensed program whose full 
name is the Virtual Machine/System Product (VM/SP). 

It is a software operating system that manages the 
resources of a real processor to provide virtual 
machines to end users. As a time-sharing system 
control program, it consists of the virtual machine 
control program (CP), the conversational monitor 
system (CMS), the group control system (GCS), and the 
interactive problem control system (IPCS). 

virtual route (VR). In SNA, a logical connection (1) 
between two subarea nodes that is physically realized 
as a particular explicit route, or (2) that is contained 
wholly within a subarea node for intranode sessions. A 
virtual route between distinct subarea nodes imposes a 
transmission priority on the underlying explicit route, 
provides flow control through virtual-route pacing, and 
provides data integrity through sequence numbering of 
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path information units (PIUs). See also explicit route 
(ER), path, and route extension. 

virtual route (VR) pacing. In SNA. a flow control tech¬ 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing . 

virtual route selection exit routine. In VTAM, an 
optional installation exit routine that modifies the list of 
virtual routes associated with a particular class of 
service before a route is selected for a requested 
LU-LU session. 

virtual storage. (ISO) The notion of storage space that 
may be regarded as addressable main storage by the 
user of a computer system in which virtual addresses 
are mapped into real addresses. The size of virtual 
storage is limited by the addressing scheme of the 
computer system and by the amount of auxiliary 
storage available, not by the actual number of main 
storage locations. 

Virtual Storage Access Method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by relative-record 
number. 

Virtual Storage Extended (VSE). An IBM licensed 
program whose full name is the Virtual Storage 
Extended/Advanced Function. It is a software oper¬ 
ating system controlling the execution of programs. 

Virtual Telecommunications Access Method (VTAM). 

An IBM licensed program that controls communication 
and the flow of data in an SNA network. It provides 
single-domain, multiple-domain, and interconnected 
network capability. 

VIT. VTAM internal trace. 

VM. Virtual Machine operating system. Its full name is 
Virtual Machine/System Product. Synonymous with 
VM/SP. 

VM SNA console support (VSCS). A VTAM component 
for the VM environment that provides Systems Network 
Architecture (SNA) support. It allows SNA terminals to 
be virtual machine consoles. 

VM/SP. Virtual Machine/System Product operating 
system. Synonym for VM. 

VR. Virtual route. 


VSAM. Virtual Storage Access Method. 

VSCS. VM SNA console support. 

VSE. Virtual Storage Extended operating system. Syn¬ 
onymous with VSEIAF . 

VSE/AF. Virtual Storage Extended/Advanced Function 
operating svstem. Synonym for VSE. 

VTAM. Virtual Telecommunications Access Method 
(IBM licensed program). Its full name is Advanced 
Communications Function for the Virtual Telecommuni¬ 
cations Access Method. Synonymous with ACF/VTAM. 

VTAM application program. A program that has 
opened an ACB to identify itself to VTAM and can now 
issue VTAM macroinstructions. 

VTAM definition. The process of defining the user 
application network to VTAM and modifying 
IBM-defined characteristics to suit the needs of the 
user. 

VTAM definition library. The operating system files or 
data sets that contain the definition statements and 
start options filed during VTAM definition. 

VTAM internal trace (VIT). A trace used in VTAM to 
collect data on channel I/O, use of locks, and storage 
management services. 

VTAM operator. A person or program authorized to 
issue VTAM operator commands. See domain oper¬ 
ator, program operator , and network operator (2). 

VTAM operator command. A command used to monitor 
or control a VTAM domain. See also definition state¬ 
ment 

VTAM Terminal I/O Coordinator (VTIOC). The part of 
TSO/VTAM that converts TSO TGET, TPUT, TPG, and 
terminal control macroinstructions into SNA request 
units. 

VTIOC. VTAM Terminal I/O Coordinator. 

wide area network. A network that provides data com¬ 
munication capability in geographic areas larger than 
those serviced by local area networks. Wide area net¬ 
works may extend across public rights-of-way. Con¬ 
trast with local area network. 

window. (1) In SNA, synonym for pacing group. (2) On 
a visual display terminal, a small amount of information 
in a framed-in area on a panel that overlays part of the 
panel. 

wrap. In general, to go from the maximum to the 
minimum in computer storage. For example, the con- 
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tinuation of an operation from the maximum value in 
storage to the first minimal value. 

XID. Exchange identification. 

XRF. Extended recovery facility. 


X.21. See Recommendation X.21 (Geneva 1980). 

X.25. See Recommendation X.25 (Geneva 1980). 

31-bit storage addressing. The storage address struc¬ 
ture available in an MVS/XA operating system. 
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Index 

A 

abbreviations 677 


alternate screen size, PSERVIC coding 87 

AMDPRDMP utility 8 

APAR (authorized programming analysis report) 6 

abend (abnormal end) 


API option 

codes 


VIT trace records created 

OAB 76, 77 


All 350 

OAC 78 


AI2 352 

OAD 78 


AI3 353 

OAx 23 


101 418 

0A9 110 


102 (MVS) 420 

OCx 22 


102 (VM) 422 

0C2 105 


102 (VSE) 420 

15D 78 


103 (MVS) 421 

878 110 


103 (VM) 423 

diagnosis procedure 19 


103 (VSE) 421 

dump 284 


RE 455 

symptoms 14 


summary 309 

trace records 


UE 479 

abend RELSTORE 354 


UP 485 

ABND SNAP 338 


APPC option 

TSO/VTAM 


VIT trace records created 

diagnosis procedure 77 


ACA1 339 

documentation requirements 

77 

ACA2 341 

symptoms 71 


ACI1 339 

VSCS 


ACI2 341 

after message DTIC10I 131 


ACPI 342 

diagnosis procedure 110 


ACP2 344 

during present initialization 

105 

ACR1 342 

during previous initialization 

103 

ACR2 344 

ABND trace record 338 


ACU1 345 

ACA1 trace record 339 


ACU2 345 

ACA2 trace record 341 


summary 309 

ACM trace record 339 


application program 

ACI2 trace record 341 


log 4 

ACPI trace record 342 


performance group specification (TSO/VTAM) 89 

ACP2 trace record 344 


problems 6 

acronyms 677 


termination (VSCS) 124 

ACR1 trace record 342 


wait 33 

ACR2 trace record 344 


AREL trace record 354 

activation 


ASCB trace field 225 

GCS 102 


asynchronous dispatch trace record 349 

VTAM recovery machine 102 


ATT (attention) trace record 355 

VTAM traces 222 


AUTH operand (TSO/VTAM) 89 

ACU1 trace record 345 


authorized 10 trace record 350 

ACU2 trace record 346 


available storage, VSCS, determining amount 107 

ADP (adapter) trace record 347 


AXIT trace record 356 

ADP2 (adapter) trace record 348 

ADSP trace record 349 

All trace record 350 

AI2 trace record 352 

AI3 trace record 353 
alert messages 288 
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B 

backspace key functions improperly 83 
BIND location 87 
BINFM, coding 74 

bracket in buffer contents trace output 80 
buffer contents trace 
confidential data 234 
description 232 
operation 233 
output 234 
when to use 232 

buffer extents, effect on performance (TSO/VTAM) 89 
buffer pool 

analyzing usage 237, 258 
control block relationships 494 
buffer use 
display 258 
trace 237 
trace format 
MVS 238 
VM 238 
VSE 240 
bus switching 299 

C 

CCI trace record 
NCSPL 359 

neither RUPE nor NCSPL 361 
RUPE 357 
CCO trace record 
NCSPL 359 

neither RUPE nor NCSPL 361 
RUPE 357 

change direction indicator in buffer contents trace 
output 80 

changing screen size in non-full-screen processing 87 
channel I/O (CIO) VIT option 
See CIO option 
channel programs 501 

channel-attachment major node, I/O trace 235 
character delete key functions improperly 83 
CIO option 

VIT trace records created 
ADPA 347 
ADPI 347 
ADPO 347 
ADP2 348 
ATT 355 
CONN 370 
DISC 385 
ERP (MVS) 391 
ERP (VM) 392, 398 
ERP (VSE) 395, 398 
HIO 405 
HIOP 406 
INT (MVS) 408 
INT (VM) 409, 412, 417 


CIO option (continued) 

VIT trace records created (continued) 


INT (VSE) 

414, 417 

LICI 426 


LICO 426 


LICS 426 


PIC 443 


PKTI 446 


PKTO 446 


PKTX 447 


SIO 417,468,475 

SIO (MVS) 

463 

SIO (VM) 466 

SIO (VSE) 

472 

SI02 (MVS) 

465 

summary 

309 

CM trace record 

362 

CI2 trace record 

366 

CI3 trace record 

368 

CI4 trace record 

369 


CLSDST PASS, possible cause for failure 74 

CMS message prefix 104 

CMS mode, LU hangs during 126 

codes, CPCB operation 

colons as incorrect output (TSO/VTAM) 85 

color 

incorrect on screen (VSCS) 124 
3279 terminal (VSCS) 126 
commands 

incorrectly processed (VSCS) 147 
rejected (TSO/VTAM) 71 
to access printer (VSCS) 146 
to change screen size in non-full-screen processing 
(TSO/VTAM) 87 

communication adapter lines, error recording for 303 
communication scanner processor 
See CSP 

component ID 3 
components 

connected to an LU 129 
in VSCS initialization 99 
concatenated input 83 

confidential data in buffer contents trace 234 
configuration data set 9 
CONN trace record 370 
console log 4 

console mode, LU hangs during 126 
content of data stream is wrong (VSCS) 126 
control blocks 

formatted in a dump 279, 280, 283 
ID codes 

for VSCS 659 
for VTAM 658 

TAB, PLB, and VLB in a dump 119 
control operator control block (COPR) 282 
control register 0 bit 30, setting 102 
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COPR (control operator control block) 282 
COI trace record 362 
C02 trace record 366 
C03 trace record 368 
C04 trace record 369 
CP message prefix 104 
CPCB operation codes 645 
CPMSG trace record 431 
CPPG trace record 371,373 
CPPT trace record 371, 373 
CPRC trace record 377 
CPTRAP 223, 225 
CPU trace field 225 
CPWAIT macro 383, 384 
CPWT trace record 379, 381 
cross-domain logon problem 75 
CSI messages, issuing component 104 
CSP (communication scanner processor) 
dump 277 
trace 251 

current entry location in VSCS internal trace table 
current LU, location (VSCS) 121 

D 

data 

display problem (TSO/VTAM) 81 
incorrect content 
TSO/VTAM 71 
VSCS 126, 138 
VTAM 57 

incorrect length (TSO/VTAM) 71 
incorrect translation (TSO/VTAM) 85 
misplaced 

TSO/VTAM 84 
VSCS 138 
default 

logmode name in USS command 87 
screen size 87 
detected waits increase 72 
DISC trace record 385 
discard reason codes 661 
disconnection 

documentation requirements (VSCS) 117 
LU hangs during (VSCS) 129 
of LU during full-screen mode (VSCS) 124 
DISP trace record 386, 388 
dispatch trace entries 
IRBs 425 
PABs 386, 388 
redispatching 459 
SRBs 477 

dispatchable, condition of VSCS 118 
dispatcher 

trace, showing loop 121 

work element queue, location in a VSCS dump 1 


dispatching priority, performance group 
specification 89 
DISPLAY command 
buffer pool use 258 
ID of TSO users 264 
NCP storage 263 
network ID 264 
network resource status 263 
route status 265 
route test 266 
trace status 264 

DMK messages, issuing component 104 
DMS messages, issuing component 104 
document problems, how to 3 
documentation for hardware failures 8 
documentation problem 
procedure 66 
symptoms 14 
DOSVSDMP utility 8 
DPACE parameter of DTIGEN macro 142 
121 DSCD trace record 389 

DTI messages, issuing component 104 

DTIC01I message 103 

DTIC02I message 103 

DTIC03I message 106 

DTIC04I message 106 

DTIC05I message with return code 204 104 

DTIC07I message with IPTYPE = 03 104 

DTIC09I message 105 

DTIC10I message 131 

DTIGEN macro 

DPACE parameter 142 
KPACE parameter 142 
PRTSHR parameter 146 
RPLNUM parameter 122 
specifying parameters in 107 
TIMEREL parameter 146 
VSAMLM parameter 143 


DTIISTRT load module 103 

DTI 1031 message 

106 

DTII04I message 

106 

DTI 1061 message 

106 

DTI 1071 message 

108 

DTI 1081 message 

108 

DTI 1091 message 

108 

DTI 1101 message 

108 

DTI 1111 message 

108 

DTI 1131 message 

109 

DTI 1141 message 

106, 109, 131 

DTIPATCH module 

302 

DTIP14! message 

120 

DTIP15I message 

106, 110 

DTIS10I message 

141 

DTIS311 message 

118 

DTIS38I message 

106 

DTIS99I message 

106,135 
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DTIUSERx selected incorrectly 

DTIV01I message 

106, 110 

DTIV04I message 

103 

DTIV05I message 

122 

DTIV06I message 

106 

DTIV07I message 

106 

DTIV09I message 

106 

DTI VI21 message 

141 

DUMP command 

286 

dumps 



ABDUMP 279 


communication scanner processor (CSP) 277 
dynamic NCP 274 

maintenance and operator subsystem (MOSS) 277 
MVS 

abend 284 

formatting and printing 279 
SNAP 284 
stand-alone 284 
SVC 284 

VTAM control blocks formatted 279, 283 
network control program (NCP) dump 277 
using independent dump utility 277 
using VTAM dump facility 275 
static NCP 274 

tracing execution sequence of VTAM components 
in 302 

viewing online 8 
VM 

DUMP command 286 
formatting and printing 279 
GDUMP 286 
SDUMP 286 
VMDUMP command 286 
VTAM control blocks formatted 280, 283 
VSE 

DUMP command 287 
formatting and printing 279 
program-initiated dump 287 
SDAID dump facility 287 
stand-alone dump utility 287 
dynamic 

NCP dump 274 
trace utility 257 

E 

echo test 300 
EDATS 126 

editing done by TPUT options 85 
enable SNA 102 
ERP trace record 
MVS 391 
VM 392, 398 
VSE 395, 398 
error recording 

communication adapter lines (VSE) 303 


error recording (continued) 
hardware 300 
intensive mode 271 
LOGREC 4 
NCP 301 
NMVT alerts 288 
SYSREC 4 

error recovery procedures 
trace record 
MVS 391 
VM 392 
VSE 395 

ESC option, VIT trace records created 
ESC trace record 399 

escape character associated with incorrect screen 
size 88 
ETRACE 223 
event IDs (EIDs) 38 
exception responses 82 
execution sequence of VTAM components in a 
dump 302 

exit routines, trace entries for 
IRB 425 
RPL 455 
SRB 477 
TPEXIT 400 
user 479 

EXIT trace record 400 

extent of a loop, determining 121 

external trace, VSCS, limiting output 102 

F 

failing module problem 
procedure 67 
failure types 

See problem types 
FBLK trace record 401 
FEATUR2 keyword 126 

formatting and printing dump output (MVS) 279 
formatting trace output 

using CPTRAP and TRAPRED 225 
using PRDMP 224 
using TAP 224 
using TPRINT 227 
FREEBLK trace entry 401 
full-screen 

application, failure symptoms 124 
description of mode (TSO/VTAM) 82 
incorrect processing (TSO/VTAM) 71 
function error (TSO/VTAM) 82 
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G 

GBLK trace record 403 
GCS (group control system) 
activation 102 
message prefix 104 
GDUMP command 286 
generalized PIU trace (GPT) 
description 245 
operation 245 
when to use 245 

generalized trace facility (GTF) 222 
GETBLK trace entry 403 
global IUCV path severed 120 
GPT 

See generalized PIU trace 
GTF 

See generalized trace facility 
GTRACE macroinstruction 223 


HALT I/O trace record 405 
hard-copy log 4 
hardware 

error recording 300 
error records 
LOGREC 4 
SYSREC 4 

problem documentation 8 
highlighting does not work correctly (VSCS) 126 
HIO trace record 405 
HIOP (halt I/O) trace record 406 
hold option, effect on performance 89 
HOLDING condition precedes a hung LU 126 
host IRN (ISTIRN), I/O trace for 235 
host physical unit (ISTPUS) 
buffer contents trace for 233 
I/O trace for 235 
hung 

LU (VSCS) 

after message DTIC10I 131 
after VARY INACT or FORCE command 132 
all LUs hung 119 
during console or CMS mode 126 
during full-screen mode 124 
during logoff or disconnect processing 129 
during logon 115 
how to recover 123 
one or more LUs hung 123 
other problems 133 
preliminary procedure 118 
when switching modes 128 
session 33 
term defined 118 
terminal (TSO/VTAM) 

diagnosis procedure 79 
documentation requirements 79 
symptoms 71 


I 

I/O pending 38 
I/O trace 

description 235 
operation 235 
output for MVS and VM 236 
output for VSE 236 
when to use 235 
IBM Support Center 68 
IBMTEST command 300 
IKJEFT01 utility 8 
IKJ608I message 71, 75 
IKT019I message 71 
IKT024I message 71 
IKT104I message 75 
IMR (intensive mode recording) 271 
incorrect 
data 

length (TSO/VTAM) 71 
translation (TSO/VTAM) 85 
line prompting (TSO/VTAM) 71 
output 

diagnosis procedure 57 
symptoms 14 
TSO/VTAM 71,84,85 
VSCS 124, 138 

parameters, VSCS messages issued 107 
processing for a mode (TSO/VTAM) 71 
screen management (TSO/VTAM) 82 
screen size 

diagnosis procedure (TSO/VTAM) 86 
documentation requirements (TSO/VTAM) 86 
due to incorrect logmode (VSCS) 124 
non-SNA 3270 terminal 87 
while dialing to VTAM (VSCS) 144 
increase in 

detected waits 72 
swap-outs 72 
indications of 

full-screen application failure 124 
incorrect logmode definition (VSCS) 124 
OPCHECK 124 
initialization 

error messages issued (VSCS) 106 
messages issued (VSCS) 103 
never completes (VSCS) 102 
problems (VSCS) 101 
input is concatenated 83 

input mode processing is incorrect (TSO/VTAM) 71 
input/output problem determination (IOPD) facility 270 
INT trace records 
MVS 408 
VM 409,412,417 
VSE 412,414,417 
intensive mode recording 271 
interactive problem control subsystem 
See IPCS 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Index 


719 



“Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


intermediate routing node (IRN), I/O trace of 235 
internal errors (VSCS) 135 
internal trace table location 
VSCS 

in a dump 121 
in storage 121 
VTAM 

in a dump 310 
in storage 309 

interpreting SVC trace entries 71 

invalid BIND in logon, detecting 74 

IOPD (input/output problem determination) facility 270 

101 trace record 418 

102 trace record 
MVS 420 
VM 422 
VSE 420 

103 trace record 
MVS 421 
VM 423 
VSE 421 

IPCS (interactive problem control subsystem) 
dump formatting with GDUMP 280 
machine-readable dumps 8 
IPTYPEs 

complete list 105 
source of in VSCS messages 104 
IRBD trace record 424 
IRBX trace record 425 
IRN, trace of (host) 235 
1ST messages, issuing component 104 
ISTPATCH module 302 
ISTPUS in traces 
buffer trace 233 
I/O trace 235 
IST400I message 75 
IST804I message 75 
IST805I message 75 
IUCV (inter-user communication vehicle) 
option card, user ID for 101 
pacing problem 142 

J 

JOBN trace field 225 

K 

keyboard 

See also hung LU 

character functions improperly 83 
locked 124 

KPACE parameter of DTIGEN macro 142 


L 

LICI (LAN interface control) trace record 426 
LICO (LAN interface control) trace record 426 
LICS (LAN interface control) trace record 426 
limiting amount of VSCS external trace output 102 
line delete key functions improperly 83 
line mode, description (TSO/VTAM) 82 
line trace 

description 246 
operation 247 
record format 

communication scanner type 2 247 

communication scanner type 3 249 

when to use 246 
link level 2 test 8, 271 
link pack area (LPA) map 5 
link-edit (XREF) map 5 
LKEX trace record 428 
LKSH trace record 429 
LL2 

See link level 2 test 
local SNA terminals, pacing values for 
(TSO/VTAM) 89 
location of 121 
BIND 87 

current entry in VSCS internal trace table 121 
dispatcher work element queue in a VSCS 
dump 121 

registers in a VSCS dump 102 
RPL pool in a dump 122 
VSCS internal trace table 
in a dump 121 
in storage 121 
LOCK option 

VIT trace records created 
LKEX 428 
LKSH 429 
summary 309 
ULKA 483 
UNLK 484 

locks 

description of 43 
log of console 4 
logical unit connection test 300 
logmode 

default name in USS command 87 
incorrectly defined, symptoms (VSCS) 124 
table entry in DLOGMOD 73 
logoff problems (VSCS) 117, 129 
logon problems 
TSO/VTAM 

ABEND0AB 76 
cross-domain network 75 
diagnosis procedure 73 
documentation requirements 73 
fails for all terminals 74 
symptoms 71 
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logon problems (continued) 

VSCS 115 

LOGREC error recording data set 4 
loop problems 

diagnosis procedure 46 

symptoms 14 

VSCS 

determining extent 121 
diagnosis procedure 118 
during initialization 107 
symptoms 121 
verifying 121 

loss of operator communications 131 
LOST trace record 430 
LPA (link pack area) map 5 
LQABs 38 
LU (logical unit) 

connection to other components (VSCS) 129 
control blocks TAB, PLB, and VLB 119 
disconnected (VSCS) 124 
recovery (VSCS) 130 
LU 6.2 message unit 435, 437 
LU-related problems, VSCS 
after message DTIC10I 131 
after VARY INACT or FORCE command 132 
all LUs are hung 119 
color terminal (3279) 126 

disconnected 124 
during console or CMS mode 126 
during full-screen mode 124 
during logoff or disconnect processing 129 
during logon 115 
global IUCV path severed 120 
highlighting does not work correctly 126 
logoff and disconnect problems 117 
LU type 1 126 

no VTAM RECEIVE ANY RPLs active 122 

one or more LUs hung 123 

other problems 133 

preliminary procedure for 118 

premature termination of user’s session 111 

Presentation Services loop causes hang 121 

printer sharing 146 

screen size is wrong 144 

SNA dial 144 

user exits 126 

VTAM Services causes a wait 120 
when switching modes 128 
3279 color terminal 126 


M 

maintenance and operator subsystem (MOSS) 
dump 277 

MAXDATA value, how to specify 83 
MDR (miscellaneous data record) 300 
Message Sent trace record 433 
messages 

‘NOT ACCEPTED’ 124 

issued for 3745 bus switching 299 

limit is reached 124 

module identification, modify 270 

prefixes 104 

problem 

procedure 53 
symptoms 14 
TSO/VTAM 

logon problems 71 
VSCS 

initialization, normal 103 
initialization, problems 106 
issued by Presentation Services 135 
issued by System Services 136 
issued by VTAM Services 136 
parameter problem 107 
source of return codes 104, 129 
miscellaneous data record (MDR) 300 
misplaced data 

See incorrect output 
mode switching errors (TSO/VTAM) 71 
MODEENT macro, description 74 
modified data tags 83 
MODIFY command 
dump 275 
IOPD 270 

message module identification 270 
NCP intensive mode recording 271 
SDLC link level 2 test 271 
trace 222 
tuning statistics 272 
module name 

finding in a dump 23 
finding in an internal trace (VIT) 313 
MORE condition precedes a hung LU 126 
MOSS dump 277 
MSG option 

VIT trace records created 
MSG 431 
MSGS 433 
OPER 441 
summary 309 
MSG trace record 431 
MSGMOD, MODIFY 270 
MSGS trace record 433 
MU1 trace record 435 
MU2 trace record 437 
MU3 trace record 438 
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MVS 

dumps 

abend 284 

formatting and printing 279 
SNAP 284 
stand-alone 284 
SVC 284 

VTAM control blocks formatted 279, 283 
performance group specification 89 
trace fields 225 

N 

NCP (Network Control Program) 
dumps 

dynamic 274 

independent dump utility 277 
static 274 

VTAM dump facility 275 
error recording 301 
intensive mode recording 271 
storage, displaying 263 
traces 

dynamic trace utility 257 
generalized PIU (GPT) 245 
line 246 

network controller line 250 
scanner interface (SIT) 251 
transmission group (TG) 252 
NetView program 
file 4 

for hardware failure 8 
hard-copy log 4 
network controller line trace 
operation 251 
output 251 
when to use 250 
network flows 561 
network status, displaying 263 
NMVT alerts 

error recording 288 

non-SNA 3270 terminal, incorrect screen size 87 
NOT ACCEPTED message 124, 126 
NRM option 

VIT trace records created 
RCE 454 

NRSP trace record 439 
NVPACE operand (TSO/VTAM) 89 


0 

OBR (outboard recorder) record 300 
online inspection of dumps 8 
OPCHECK symptoms 124 
OPER trace record 441 
operation checks 71 
operation codes, CPCB 645 
operator 

commands processed incorrectly (VSCS) 147 
console cannot communicate with VSCS 131 
option, TPUT, location of 84 
outboard recorder (OBR) record 300 
output 

queue, pointer to first element 80 
wait condition 89 

overview of normal VSCS initialization 99 

P 

PAB DISPATCH trace record 386, 388 
PABs (process anchor blocks) 36, 37 
pacing 

IUCV 142 

values for local SNA terminals (TSO/VTAM) 89 
parameters 

error messages (VSCS) 107 
specifying in DTIGEN macro 107 
patch area 

TSO/VTAM 302 
VSCS 302 
VTAM 302 
performance group 
how to specify 89 
location of 89 
performance problem 

diagnosis procedure 62, 89 
symptoms 14 
TSO/VTAM 

documentation requirements 89 
symptoms 72 
VSCS 143 

PIC (packet interface) trace record 443 
PIU discard reason codes 661 
PIU option 

VIT trace records created 
DSCD 389 
NRSP 439 
PIU 444 
summary 309 
PIU too long 83 
PIU trace record 444 
PKTI (packet) trace record 446 
PKTO (packet) trace record 446 
PKTX (packet extension) trace record 447 
PLB control block 119 
POST trace record 448 
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PRDMP utility 224 
premature termination 
ofVSCS 110 

of VSCS user’s session 111 
Presentation Services 
large enabled loop 121 
messages issued by 135 
primary screen size, PSERVIC coding for 87 
printer 

commands for accessing (VSCS) 146 
not released (VSCS) 146 
sharing (VSCS) 146 

PRINTER command causes VTAM SIMLOGON 
failure 146 
printing output 
dumps 

using ABDUMP (MVS) 279 
using IPCS (VM) 280, 283 
using PRDMP (MVS) 281 
using PRTDUMP (VM) 280 
using SADMP (MVS) 283 
using SDUMP (VM) 283 
traces 

using CPTRAP and TRAPRED 225 
using PRDMP 224 
using TAP 224 
using TPRINT 227 
problem determination commands 
DISPLAY 

buffer pool use 258 
NCP storage 263 
network status 263 
route status 265 
route test 266 
MODIFY 

intensive mode recording 271 
IOPD 270 
link level 2 test 271 
message module identification 270 
tuning statistics 272 
problem documentation 3 
problem symptoms 

abnormal end (abend) 14 
documentation 14 
incorrect output 14 
listed 14 
loop 14 
message 14 
performance 14 
program check 14 
wait 14 
problem types 
abend 19 
documentation 66 
failing module 67 
incorrect output 57 
loop 46 


problem types (continued) 
message 53 
performance 62 
program check 25 
wait 29 

procedure for reporting problems 68 
procedures 

abnormal end 19 
documentation 66 
failing module 67 
incorrect output 57 
loop 46 
message 53 
performance 62 
program check 25 
reporting 68 
wait 29 

process anchor blocks (PABs) 36, 37 
processing is hung (TSO/VTAM) 71 
program 

-initiated dump 287 
check 

after message DTIC10I 131 
diagnosis procedure 25 
symptoms 14 
temporary fix (PTF) 3 
update tape (PUT) 3 
PROGxxx message 
TSO/VTAM 71 
VSCS 124 
PRTDUMP utility 8 

PRTSHR parameter of DTIGEN macro 146 
PSS option 


VIT trace 

records created 

ADSP 

349 

AXIT 

356 

DISP 

386, 388 

ESC 

399 

EXIT 

400 

IRBD 

424 

IRBX 

425 

POST 

448 

QUE 

450, 452 

QUEN 

453 

RESM 

459 

SCHD 

460, 462 

SRBD 

476 

SRBX 

477 

summary 309 

WAIT 

489 


PTF (program temporary fix) eyecatcher 3 
PVM (pass-through VM virtual machine) 144 
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Q 

QREQ trace record 449 

QUE trace record 450, 452 

QUEN trace record 453 

QUEUED REQSTORE trace record 458 

R 

RCE trace record 454 
RE trace record 455 
recovering an LU (VSCS) 130 
registers, location in a dump (VSCS) 102 
releasing a printer (VSCS) 146 
releasing VSCS LU 130 
RELS trace record 457 
repeated error record entries 
LOGREC 50 
SYSREC 50 
reporting procedure 68 
REQS trace record 458 
request parameter header 
See RPH 

reshow processing, description 82, 84 

RESM trace record 459 

response time slow (TSO/VTAM) 72 

resume address field in RPH 40 

RETRACE listing 9 

return codes, source (VSCS) 104, 129 

route 

status, display 265 
test, display 266 
RPH (request parameter header) 
finding 40 
waiting 40 

RPL EXIT trace record 455 
RPL request type, location in dump of SDWA 77 
RPLFDBK2, location in dump of SDWA 77 
RPLFDB2, location in dump of SDWA 77 
RPLNUM parameter of DTIGEN macro 
default value 122 
description 122 

RPLRTNCD, location in dump of SDWA 77 
RPLs, VTAM RECEIVE ANY 
address of each 122 
description 122 
inactive 122 
location in a dump 122 
total number 122 
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S 

save area 

conventions 304 
loop extent shown in 121 
scanner interface trace (SIT) 
description 251 
operation 252 
when to use 252 
SCHD trace record 460, 462 
screen management problems, TSO/VTAM 
diagnosis procedure 81 
documentation 81 
symptoms 71 
screen size 

changing, in non-full-screen processing 87 

default value 87 

incorrect 

TSO/VTAM 84, 86 
VSCS 124, 144 
PSERVIC coding 87 
TSO/VTAM problems 72 
SCRSIZE operand 87 
SDAID dump facility 287 
SDLC link level 2 test, modify 271 
SDUMP utility 286 

SDWA (system diagnostic work area) 5 
sense data 
in I/O trace 

MVS and VM 236 
VSE 237 

in transmission group trace 
MVS and VM 255 
VSE 256 
service aids 

alert messages 288 

error recording for communication adapter 
lines 303 

hardware error recording 300 

logical unit connection test (IBMTEST) 300 

messages for 3745 bus switching 299 

NCP error recording 301 

NCP intensive mode recording 271 

patch area 301 

recording NMVT alerts in LOGREC or SYSREC 288 
VTAM 221 
session 

awareness data 9 

parameters, defining (TSO/VTAM) 73 
trace data 9 

SIMLOGON fails after PRINTER command (VSCS) 146 
SIO trace record 
MVS 463 
VM 466, 468, 475 
VSE 468, 472, 475 
SI02 trace record 
MVS 465 
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slow response time 
general procedure 62 
TSO/VTAM 72 
VSCS 143 
SMS (buffer use) trace 
description 237 
format 

MVS 238 
VM 238 
VSE 240 
operation 238 
when to use 238 
SMS option 

VIT trace records created 
AREL 354 
FBLK 401 
GBLK 403 
QREQ 449 
RELS 457 
REQS 458 
summary 309 
VTAL 487 
VTFR 488 

SNA 

dial problems (VSCS) 144 
enable 102 

terminals, local, pacing values for (TSO/VTAM) 89 
SNAP 

abend 338 
dump 284 
trace record, VIT 314 
source of IPTYPEs and return codes in VSCS 
messages 104,129 
source of messages 
CSI 104 
DMK 104 
DMS 104 
DTI 104 
1ST 104 

SRBD trace record 476 
SRBX trace record 477 
SRT trace record 478 
SSCP option 

VIT trace records created 
CCI for NCSPL 359 
CCI for RUPE 357 
CCI, neither RUPE nor NCSPL 361 
CCO for NCSPL 359 
CCO for RUPE 357 
CCO, neither RUPE nor NCSPL 361 
CM 362 
CI2 366 
CI3 368 
CI4 369 
COI 362 
C02 366 
C03 368 
C04 369 
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SSCP option (continued) 

VIT trace records created (continued) 

CPPG 371,373 
CPPT 371,373 
CPRC 377 
CPWT 379,381 
SRT 478 
summary 309 
stand-alone dump 
MVS 284 
VSE 287 

START I/O trace record 
MVS 463,465 
VM 466 
VSE 472 

starting address of the VSCS internal trace table 121 
static NCP dump 274 
status, display of 263 
storage 

available, determining amount (VSCS) 107 
shortage (VSCS) 111 
storage related problem 
VSCS 140 

STSIZE macro, changing screen size with 87 
SUMDUMP option 281 
Support Center 68 
SVC dump 284 

swap count, incorrect incrementation 89 
swap-outs increase 72 
symptom string 
description 5 
MVS 21 
VM 21 
VSE 27 
symptoms 
abend 14,71 

documentation problem 14 
full-screen application failure 124 
hung terminal 71,118 
incorrect logmode definition 124 
incorrect output 14 
initialization problem 98 
logon problem 71, 98 
loop problem 14, 98,121 
message problem 14, 98 
OPCHECK 124 

performance problem 14, 72, 98 
printer sharing problem 98 
program check 14 
screen management problems 71 
screen size problems 72 
SNA dial problem 98 
termination problem 98 
wait problem 14, 98 

synchronous and asynchronous processing 120 
SYSREC error recording data set 4 
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system diagnostic work area (SDWA) 5 
System Services, messages issued by 136 
SYS1.LOGREC error recording data set 4 

T 

TAB control block 119 
TAP (trace analysis program) 224 
techniques to recover a hung LU (VSCS) 123 
terminal 

cannot log on 73, 115 
definition statement 74 
device problem 7, 50, 59 
hung 79,119,123 
incorrect output problem 87, 138 
name, location in dump of SDWA 77 
pacing values 89 
recovery when hung 123 
user echo test 300 
termination 
TSO/VTAM 
abend 77 
during logon 73 
VSCS 

abend 110 

immediately upon starting 103 
never completes 109 
premature 110 

unexpectedly, via operator command 112 
user’s session 111 
TGET/TPUT trace 

See TSO/VTAM TGET/TPUT trace 
TIMEREL parameter of DTIGEN macro 146 
timing problems caused by synchronous and asynchro¬ 
nous processing 120 
TNSTAT (tuning statistics), modify 272 
TPESC trace record 399 
TPEXIT trace record 400 
TPIO trace record 418 
TPLOCK EXCLUSIVE trace record 428 
TPLOCK SHARED trace record 429 
TPMSG trace record 431 
TPPOST trace record 448 
TPQUE NONE trace record 453 
TPQUE trace record 450, 452 
TPRINT utility 227 
TPSCHED trace record 460, 462 
TPUNLOCK ALL trace record 483 
TPUNLOCK trace record 484 
TPUT option 
editing 85 
location 84 
trace 

activating 222 
analysis program (TAP) 224 
buffer contents 232 
buffer use (SMS) 237 


trace (continued) 

component execution sequence 302 

dynamic trace utility 257 

fields 

MVS-only 225 
VM-only 226 

generalized PIU (GPT) 245 
I/O 235 

internal (VIT) 307 
line 246 
printing 

CPTRAP and TRAPRED 225 
PRDMP 224 
TPRINT 227 
records, VIT 

scanner interface (SIT) 251 
SMS (buffer use) 237 
summary 221,222 
table header record (VIT) 310 
TGET/TPUT, for TSO/VTAM 241 
transmission group (TG) 252 
trace entries 

adapter 347, 348 
CIO error recovery 398 
halt I/O 406 
interrupt 412,417 
LAN interface control 426 
packet 446 
packet extension 447 
packet interface 443 
start I/O 468, 475 
traces 

See VTAM traces, NCP traces 
translation 

incorrect (TSO/VTAM) 85 
tables (TSO/VTAM) 85 
transmission group (TG) trace 
description 252 
operation 253 
output for MVS and VM 254 
output for VSE 255 
when to use 252 
TRAPRED 

EFF2 option 247 
manual for information 226 
TRAPRED utility 
description 225 
TSO EDIT problems 71 

TSO TERMINAL command, changing screen size 
with 87 

TSO/VTAM problems 
ABEND0AB 77 
ABEND0AC 78 
ABEND0AD 78 
ABEND15D 78 
data misplaced on screen 84 
data translated incorrectly 85 
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TSO/VTAM problems (continued) 
exception responses 82 
extra data 83 

first logon from a particular device fails 74 

first logon using USS commands fails 73 

function error 82 

hung terminal 79 

incorrect data translation 85 

incorrect screen size 86 

logon fails 73 

misplaced data on screen 84 
missing data 83 

mode error (incorrect screen management) 82 
performance 89 
response time is slow 72 
screen is always wrong size 87 
screen is wrong size for mode 87 
screen management 81 
translation of data 85 
TSO/VTAM TGET/TPUT trace 
description 241 
operation 242 
output 242 
when to use 241 
tuning 89 

tuning statistics (TNSTAT), modify 272 
TVWABOQ 80 

u 

UE trace record 479 
ULKA trace record 483 
UNLK trace record 484 
UP trace record 485 
user cannot log on 
TSO/VTAM 73 
VSCS 120 
user edit exits 
TSO/VTAM 

description 83 
when to use 85 
where to find list of 85 
VSCS 126 

USER EXIT trace record 479 
user ID for IUCV option card 101 
USER POST trace record 485 
USRxx trace field 225 
USS commands used in logon 73 
USS message 10 71 

USS message 7 71 


verifying a loop (VSCS) 121 
VIT 

See VTAM internal trace 
VLB control block 119 
VM 

directory, user ID for IUCV option card 101 
dumps 

DUMP command 286 
formatting and printing 279 
GDUMP 286 
SDUMP 286 
VMDUMP command 286 
VTAM control blocks formatted 280, 283 
trace fields 226 
VMBLOK status 132 
VMDUMP command 286 
VSAMLM parameter of DTIGEN macro 143 
VSCS 

initialization 

components involved 99 
loops 107 

messages indicating problems 106 
messages showing success 103 
source of IPTYPEs and return codes in 
messages 104 
internal problems 135 
internal trace table 

location in a dump 121 
location in storage 121 
message prefix 104 

messages, source of return codes 106, 129 
overview of normal process 99 
PRINTER command causes VTAM SIMLOGON 
failure 146 
problems 

abends 110 
all LUs hung 119 
disconnect 117 

documentation requirements 93 

global IUCV path severed 120 

how to trace 93 

incorrect output 138 

incorrect parameters, messages for 107 

initialization 101 

IUCV pacing 142 

logoff 117 

logon 115 

loop 118 

loop during initialization 107 
LU hangs after message DTIC10I 131 
LU hangs during console or CMS mode 126 
LU hangs during full-screen mode 124 
LU hangs during logoff or disconnect 
processing 129 

LU hangs when you switch modes 128 
LU stays hung after VARY INACT or FORCE 
command 132 
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VSCS (continued) 
problems (continued) 

misspelled or missing parameters 101 
no VTAM RECEIVE ANY RPLs active 122 
one or more LUs hung 123 
operator command does not complete 134 
operator command is rejected 147 
performance 143 

premature termination of user’s session 111 

premature termination of VSCS 110 

Presentation Services in large enabled loop 121 

printer sharing 146 

screen size is incorrect 144 

SNA dial 144 

storage 140 

storage shortage 101,111 
symptoms 98 
termination 109 

termination immediately upon starting 103 
timing 120 

users cannot log on 120 
VTAM Services 120 
wait 118 

storage available, determining amount 107 
termination messages 109 
VSE 
dumps 

DUMP command 287 
formatting and printing 279 
program-initiated dump 287 
SDAID dump facility 287 
stand-alone dump utility 287 
VTAL trace record 487 
VTAM 

buffer pool use 237 
channel programs 501 
commands for problem determination 257 
control blocks formatted in a dump 
MVS 279,283 
VM 280,283 
dump facility 275 
execution sequences 302 
locks 43 

message prefix 104 
PIU discard reason codes 661 
printer commands for VSCS 146 
RECEIVE ANY RPLs 
address of each 122 
description 122 
inactive 122 
location in a dump 122 
total number 122 
recovery machine, activating 102 
service aids 221 
SIMLOGON fails 146 
trace fields 

MVS-only fields 225 
VM-only fields 226 


VTAM (continued) 
traces 

activating 222 
buffer contents 232 
buffer use (SMS) 237 
I/O 235 
internal 307 

printing with CPTRAP and TRAPRED 225 
printing with PRDMP 224 
printing with TAP 224 
printing with TPRINT 227 
SMS (buffer use) 237 
TGET/TPUT, for TSO/VTAM 241 
wait state indications 14 
VTAM internal trace (VIT) 339, 341, 344, 345, 346 
activation 

MODE = EXT 311 
MODE = INT 309 
OPTION operand 307 
deactivation 315 

module names in trace records 313 
record descriptions 
ABND 338 
ACA1 339 
ACA2 341 
ACI1 339 
AC12 341 
ACPI 342 
ACP2 344 
ACR1 342 
ACR2 344 
ACU1 345 
ACU2 345 
ADPA 347 
ADPI 347 
ADPO 347 
ADP2 348 
ADSP 342, 349 
All 350 
AI2 352 
AI3 353 
AREL 354 
ATT 355 
AXIT 356 
CCI for NCSPL 359 
CCI for neither RUPE nor NCSPL 361 
CCI for RUPE 357 
CCO for NCSPL 359 
CCO for neither RUPE nor NCSPL 361 
CCO for RUPE 357 
CM 362 
CI2 366 
CI3 368 
C14 369 
CONN 370 
COI 362 
C02 366 
C03 368 
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VTAM internal trace (VIT) (continued) 
record descriptions (continued) 
C04 369 

CPPG 371,373 
CPPT 371,373 
CPRC 377 
CPWT 379, 381 
DISC 385 
DISP 386, 388 
DSCD 389 
ERP for MVS 391 
ERP for VM 392, 398 
ERP for VSE 395, 398 
ESC 399 
EXIT 400 
FBLK 401 
GBLK 403 
HIO 405 
HIOP 406 
INT for MVS 408 
INTfor VM 409, 412, 417 
INT for VSE 414,417 

101 418 

102 for MVS 420 
102 for VM 422 

102 for VSE 420 

103 for MVS 421 
103 for VM 423 
103 for VSE 421 
IRBD 424 
IRBX 425 

LICI 426 
LICO 426 
LICS 426 
LKEX 428 
LKSH 429 
LOST 430 
MSG 431 
MSGS 433 
MU1 435 
MU2 437 
MU3 438 
NRSP 439 
OPER 441 
PIC 443 
PIU 444 
PKTI 446 
PKTO 446 
PKTX 447 
POST 448 
QREQ 449 
QUE 450, 452 
QUEN 453 
RCE 454 
RE 455 
RELS 457 
REQS 458 
RESM 459 


VTAM internal trace (VIT) (continued) 
record descriptions (continued) 
SCHD 460, 462 
SIO 468, 475 
SIO for MVS 463 
SIO for VM 466 
SIO for VSE 472 
SI02 for MVS 465 
SRBD 476 
SRBX 477 
SRT 478 
UE 479 
ULKA 483 
UNLK 484 
UP 485 
VTAL 487 
VTFR 488 
WAIT 489 

record summary 315 
SNAP trace record 314 
trace table header record 310 
VTAM Services 

messages issued by 136 
task problem 120 
VTAMMAP control card 282 
VTFR trace record 488 


W 

wait 

application program 33 
caused by VTAM Services 120 
due to synchronous and asynchronous 
processing 120 
during VSCS termination 109 
option 89 
session 33 
symptoms 14, 121 
wait problem 

diagnosis procedure 29, 118 
WAIT trace record 489 
waiting 

request element (WRE) 38, 39 
RPH 40 

ways to recover a hung LU (VSCS) 123 
work areas (to trace execution sequences) 302 
wrapping of data on screen 84 
WRE (waiting request element) 38, 39 
write control character in buffer contents trace 
output 80 
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x 

XREF (link-edit) map 5 

Numerics 

3279 color terminal 126 

3720 communication controller, alert messages 
from 288 

3725 communication controller, alert messages 
from 288 

3745 communication controller 
alert messages from 288 
bus switching 299 


730 VTAM Diagnosis 


LY30-5601-1 €> Copyright IBM Corp. 1984, 1989 



Reader's Comment Form 


VTAM 

Diagnosis 

Publication No. LY30-5601 -1 

This manual is part of a library that serves as a reference source for systems 
analysts, programmers, and operators of IBM systems. You may use this form to 
communicate your comments about this publication, its organization, or subject 
matter, with the understanding that IBM may use or distribute whatever information 
you supply in any way it believes appropriate without incurring any obligation to 
you. 

Note: Copies of IBM Publications are not stocked at the location to which this form 
is addressed. Please direct any requests for copies of publications, or for 
assistance in using your IBM system, to your IBM representative or to the IBM 
branch office serving your locality. 

Possible topics for comment are: clarity, accuracy, completeness, organization, 
coding, retrieval, and legibility. 

Comments: 


What Is your occupation? 


If you wish a reply, give your name, company, mailing address, and date: 


Thank you for your cooperation. No postage stamp necessary if mailed in the 
U.S.A. (Elsewhere, an IBM office representative will be happy to forward your 
comments or you may mail directly to the address in the Edition Notice on the back 
of the title page.) 
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